# openalex-mcp-server MCP server

Access the OpenAlex academic research catalog - 270M+ publications via MCP. STDIO & HTTP.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-openalex-mcp-server
- Repository: https://github.com/cyanheads/openalex-mcp-server

## Install
- Command: `npx -y @cyanheads/openalex-mcp-server`
- Endpoint: https://openalex.caseyjhand.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm @cyanheads/openalex-mcp-server v0.6.9
- Environment variable: OPENALEX_API_KEY (required)
- Environment variable: OPENALEX_BASE_URL (default https://api.openalex.org)
- Environment variable: MCP_LOG_LEVEL (default info)
- Package: Npm @cyanheads/openalex-mcp-server v0.6.9
- Environment variable: OPENALEX_API_KEY (required)
- Environment variable: OPENALEX_BASE_URL (default https://api.openalex.org)
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://openalex.caseyjhand.com/mcp

## Tools
- openalex_resolve_name (Openalex Resolve Name) - Resolve a name or partial name to an OpenAlex ID. Returns up to 10 matches with disambiguation hints. ALWAYS use this before filtering by entity — names are ambiguous, IDs are not. Also accepts DOIs directly for quick lookup. Endpoint: https://openalex.caseyjhand.com/mcp
- openalex_search_entities (Openalex Search Entities) - Search, filter, sort, or retrieve by ID. Covers all OpenAlex entity types (works, authors, sources, institutions, topics, keywords, publishers, funders). Pass `id` to retrieve a single entity. Otherwise, use `query` and/or `filters` for discovery. Supports keyword search with boolean operators, exact phrase matching, and AI semantic search. Use openalex_resolve_name to resolve names to IDs before filtering. Searches return a curated set of fields by default; pass `select` to override with specific fields. Endpoint: https://openalex.caseyjhand.com/mcp
- openalex_analyze_trends (Openalex Analyze Trends) - Aggregate OpenAlex entities into groups and count them. Use for trend analysis (group works by publication_year), distribution analysis (group by oa_status, type, country), and comparative analysis (group by institution or topic). Combine with filters to scope the analysis. Returns up to 200 groups per page — use cursor pagination for fields with many distinct values. Endpoint: https://openalex.caseyjhand.com/mcp

## Resources
Not captured

## Prompts
- openalex_literature_review - Guides a systematic literature search: formulate query, search, filter, analyze citation network, synthesize findings. Arguments: topic, scope
- openalex_research_landscape - Analyzes the research landscape for a topic: volume trends, top authors/institutions, open access rates, funding sources. Arguments: topic

## Metadata
- Owner: io.github.cyanheads
- Version: 0.6.9
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 8, 2026
- Source: https://registry.modelcontextprotocol.io