otherapi_key

OpenAlex

OpenAlex is an open catalog of scholarly works, authors, institutions, sources, topics, and related research metadata.

Verdict

OpenAlex gives your team direct access to 250+ million scholarly works, authors, institutions, and citation graphs without scraping publisher sites. @mention it to search academic literature by topic or author, pull metadata for specific papers, build reading lists in private collections, or download PDFs when available. Researchers writing literature reviews get the most mileage — you can autocomplete partial titles, filter by publication year or citation count, and export structured metadata. The PDF download tool costs $0.01 per file and respects source copyright, so budget accordingly for bulk retrieval.

Common use cases

  • Build annotated bibliographies for grant proposals
  • Track citation counts for competitor research
  • Find co-author networks across institutions
  • Curate reading lists in private collections
  • Export structured metadata for meta-analyses

Integration

Vendor
OpenAlex
Category
other
Auth
API_KEY
Tools
14
Composio slug
openalex

Tools

  • Add Collection Entities

    Bulk-add one or more matching OpenAlex entity IDs to an owned collection without duplicating existing memberships.

  • Autocomplete Entities

    Resolve a partial name or title to likely OpenAlex entity IDs before filtering or retrieving metadata.

  • Create Collection

    Create a private, single-entity-type OpenAlex collection, optionally with an initial bounded set of entity IDs.

  • Delete Collection
    destructive

    Permanently delete exactly one owned private OpenAlex collection and all of its collection memberships. This does not delete the underlying OpenAlex entities.

  • Download Work Content

    Download an OpenAlex-cached PDF or gzipped GROBID TEI file for a work. Choose the format matching the work's has_content flags. Each call currently costs $0.01, and source copyright terms still apply.

  • Get Collection

    Get metadata for one private OpenAlex collection owned by the connected user.

  • Get Metadata Entity

    Retrieve one OpenAlex work, author, source, institution, topic, keyword, publisher, funder, award, taxonomy item, country, continent, or language by its supported identifier. Returns the provider's entity object directly; use select to limi

  • Get Rate Limit Status

    Validate the connected OpenAlex API key and inspect daily budget, prepaid balance, reset timing, and current endpoint costs before expensive queries or downloads.

  • List Collection Entities

    List one page of entity IDs in an owned private collection together with collection metadata and page totals.

  • List My Collections

    List private OpenAlex collections owned by the connected API-key user, optionally finding collections that contain an entity.

  • Query Metadata Entities

    Search, filter, sort, sample, select, or group one OpenAlex metadata resource other than works, including authors, venues, organizations, taxonomy, geography, awards, and enumerations. Returns one cursor-controlled page.

  • Query Works

    Search, filter, sort, sample, select, or group scholarly works. Returns one cursor-controlled page and its OpenAlex query cost; use the snapshot for whole-catalog exports.

  • Remove Collection Entities
    destructive

    Bulk-remove one or more entity memberships from an owned private OpenAlex collection without deleting the underlying OpenAlex entities.

  • Update Collection

    Update a private collection's name or description, or change its entity type while the collection is empty. Provide at least one of display_name, description, or entity_type.

Setup

Setup guide

  1. 1Click Integrations in your Switchy workspace sidebar, find OpenAlex under Research & Data, then click Connect. You'll be prompted to paste an API key — get yours free at openalex.org/account after signing up with email. Copy the key and paste it into Switchy's auth dialog. Grant read and collection-management scopes when prompted. Click Test Connection to verify your daily rate limit and prepaid balance appear. Open any Project, type '@OpenAlex' in the chat, and ask it to autocomplete a paper title or search for works on a topic. If metadata returns in seconds, the connection works. To download a PDF, first retrieve a work's metadata to confirm has_content flags are true, then call the download tool with the work ID and your preferred format.

What teammates see: by default, memories from OpenAlex are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Find Recent Climate Papers

@OpenAlex search for works about climate adaptation published after 2022, sort by cited_by_count descending, return the top 10 with titles and DOIs

Autocomplete Paper Title

@OpenAlex autocomplete the title 'attention is all you' and return the top 3 matching work IDs with their full titles and publication years

Create Reading List Collection

@OpenAlex create a collection named 'Transformer Architecture Papers' for works, then add the entity IDs for the top 5 most-cited papers on transformer models published since 2017

Download Paper PDF

@OpenAlex get metadata for work W2964141474 to check has_content flags, then download the PDF if available and confirm the file size

Check Rate Limit Budget

@OpenAlex get my current rate limit status including daily budget remaining, prepaid balance, and per-endpoint costs

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@OpenAlex search for recent papers on transformer architectures in natural language processing and show me the top 5 by citation count

Output

Here are the top 5 papers on transformer architectures in NLP by citation count: 1. "Attention Is All You Need" (Vaswani et al., 2017) – 89,432 citations 2. "BERT: Pre-training of Deep Bidirectional Transformers" (Devlin et al., 2019) – 67,821 citations 3. "Language Models are Few-Shot Learners" (Brown et al., 2020) – 34,567 citations 4. "Improving Language Understanding by Generative Pre-Training" (Radford et al., 2018) – 28,943 citations 5. "XLNet: Generalized Autoregressive Pretraining" (Yang et al., 2019) – 19,234 citations Each entry includes DOI, abstract, author affiliations, and open-access status. This is an illustrative example; actual results depend on OpenAlex's current index.

Notes

This example demonstrates OpenAlex's core strength: comprehensive academic metadata search across 250M+ works. The autocomplete and metadata retrieval tools work together to resolve queries and return structured bibliographic data. No special auth scopes required beyond a valid API key, but complex queries count against your daily rate limit.

Prompt

@OpenAlex create a collection called 'Q1 Literature Review' and add these five papers to it so I can track them for my research project

Output

Collection 'Q1 Literature Review' created successfully (ID: col_abc123xyz). All 5 works have been added: - W2964141474: "Attention Is All You Need" - W2807374136: "BERT: Pre-training..." - W3037662171: "Language Models are Few-Shot..." - W2809633644: "Improving Language Understanding..." - W2963436189: "XLNet: Generalized Autoregressive..." You can retrieve this collection anytime using its ID. This is an illustrative example showing how the create and bulk-add tools coordinate to organize research materials.

Notes

This showcases OpenAlex's collection management for organizing research. Collections are private to your account and persist across sessions. Important: collections are single-entity-type only (works, authors, etc. cannot mix), and deleting a collection does not affect the underlying OpenAlex entities. Useful for literature reviews, grant proposals, or collaborative research tracking.

Prompt

@OpenAlex check my rate limit status, then download the full-text PDF for the Attention Is All You Need paper if I have budget remaining

Output

Rate limit check: You have 847 queries remaining today (resets in 14 hours). Prepaid balance: $12.40. PDF download cost: $0.01. Downloading PDF for W2964141474 ("Attention Is All You Need")... Complete. The 15-page PDF has been retrieved from OpenAlex's cache. Note: This is an illustrative example. Actual downloads depend on whether OpenAlex has cached content for the work (check has_content flags first), and you must comply with the original publisher's copyright terms even though OpenAlex hosts the file.

Notes

This example highlights two critical tools: rate-limit inspection before expensive operations, and content download for works with cached PDFs or GROBID XML. Each download costs $0.01 from your prepaid balance, so always check budget first. Not all works have downloadable content—verify has_content flags in the metadata before attempting. Downloaded files remain subject to original copyright restrictions.

Use-case deep-dives

Literature review for grant writing

When OpenAlex beats manual citation chasing for small research teams

A three-person academic lab writing an NIH R01 needs 40-60 recent papers on CRISPR delivery mechanisms, filtered by citation count and open-access status. OpenAlex's autocomplete and metadata tools let you build that list in under an hour without touching PubMed's clunky interface or paying Scopus fees. The collection tools keep your shortlist in one place while you draft the background section. The catch: if you need full-text analysis of paywalled papers, OpenAlex only caches open-access PDFs—you'll still hit institutional login walls for half your sources. For teams writing one or two grants a year, the API key is free and the workflow is faster than spreadsheet hell.

Competitive intelligence for biotech startups

Track competitor publications without a $15k Scopus contract

A six-person biotech startup monitors 12 competitor labs by author and institution, pulling new publications weekly to spot IP risks or partnership signals. OpenAlex's author and institution metadata tools make this a 20-minute Slack standup ritual instead of a half-day manual search. You create one collection per competitor, add entities as they publish, and export the list to your CTO. The rate limit status tool matters here—if you're downloading dozens of PDFs for patent prior-art searches, the $0.01-per-download fee adds up fast. For monitoring and triage, OpenAlex is the right call. For deep patent work, you still need a real IP database.

Podcast research for science communicators

When OpenAlex works for episode prep but not live fact-checking

A two-person science podcast team preps episodes on topics like microplastics or fusion energy by pulling 15-20 landmark papers, checking author affiliations, and verifying funding sources. OpenAlex's metadata retrieval and funder tools give you that context in minutes, and the autocomplete helps when a guest mentions a paper title mid-interview. The workflow breaks if you need real-time lookups during recording—API calls take 2-4 seconds, and the interface isn't built for live search. Use OpenAlex in the research phase, then screenshot or print the key facts. For a weekly show, the free tier covers your volume and the metadata depth beats Google Scholar.

Frequently asked

What does the OpenAlex MCP do in Switchy?

It connects your team to OpenAlex's academic metadata database — 250M+ research papers, authors, institutions, and citations. You can search works by title or DOI, pull author profiles, create private collections of papers, and download cached PDFs when available. Useful for literature reviews, citation analysis, or building research datasets without scraping publisher sites.

Do I need a paid OpenAlex API key to use this MCP?

Yes. OpenAlex requires an API key for all MCP operations. The free tier gives you rate limits; paid tiers unlock higher quotas and PDF downloads (currently $0.01 per file). You can check your daily budget and prepaid balance directly through the Get Rate Limit Status tool before running expensive queries.

Can the OpenAlex MCP download full-text PDFs of papers?

Only when OpenAlex has cached a PDF for that work. Use the Download Work Content tool after checking the work's has_content flags. Each download costs $0.01 against your OpenAlex prepaid balance, and the original publisher's copyright terms still apply — this isn't a paywall bypass, just a convenience cache.

How is this different from searching Google Scholar or PubMed directly?

OpenAlex gives you structured JSON metadata and bulk operations — create collections of 500 papers, autocomplete author names, filter by institution or funder — instead of clicking through paginated web results. It's faster for programmatic workflows like citation mapping or tracking an author's output, but won't replace reading the actual papers.

Who on the team should connect the OpenAlex MCP?

Whoever holds the OpenAlex API key and understands your research scope. Collections are private to the connected user, so if multiple people need access to the same paper sets, either share one Switchy workspace or coordinate collection exports. The MCP doesn't sync collections across team members automatically.

More other MCPs

See all other MCPs →

Data last verified 62 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.