Skip to content
MCP server

Openalex MCP Server

Access the OpenAlex academic research catalog — 270M+ publications.

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.11.1
Listing updated
4 days ago

About Openalex MCP Server

Openalex MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add --transport http openalex-mcp-server https://openalex.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://openalex.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openalex-mcp-server": {
      "url": "https://openalex.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openalex-mcp-server": {
      "type": "http",
      "url": "https://openalex.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openalex-mcp-server": {
      "serverUrl": "https://openalex.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openalex-mcp-server": {
      "type": "http",
      "url": "https://openalex.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • OPENALEX_CLAMP_PER_PAGEClamp oversized count inputs (per_page, semantic-search per_page, sample, slice.limit) to their caps with a notice. Set false to reject them instead.
  • OPENALEX_FILTER_STRING_INPUTAccept unambiguous native filter strings on search_entities. Set false to require record objects.
  • OPENALEX_FILTER_RECORD_REPAIRAccept boolean and number values, nested objects, and quoted keys in the filters record, with a notice. Set false to require string values under dotted keys.
  • OPENALEX_SELECT_STRING_INPUTAccept a comma-separated select string on search_entities and get_citation_graph, with a notice. Set false to require an array.
  • OPENALEX_API_KEYOpenAlex account API key, sent as api_key= - optional (free from https://openalex.org/settings/api). Without it, anonymous rate limits apply.
  • OPENALEX_MAILTOOptional email sent as mailto= to identify yourself to OpenAlex (the polite pool). Separate from the API key.
  • OPENALEX_BASE_URLOpenAlex API base URL.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • OPENALEX_CLAMP_PER_PAGEClamp oversized count inputs (per_page, semantic-search per_page, sample, slice.limit) to their caps with a notice. Set false to reject them instead.
  • OPENALEX_FILTER_STRING_INPUTAccept unambiguous native filter strings on search_entities. Set false to require record objects.
  • OPENALEX_FILTER_RECORD_REPAIRAccept boolean and number values, nested objects, and quoted keys in the filters record, with a notice. Set false to require string values under dotted keys.
  • OPENALEX_SELECT_STRING_INPUTAccept a comma-separated select string on search_entities and get_citation_graph, with a notice. Set false to require an array.
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • OPENALEX_API_KEYOpenAlex account API key, sent as api_key= - optional (free from https://openalex.org/settings/api). Without it, anonymous rate limits apply.
  • OPENALEX_MAILTOOptional email sent as mailto= to identify yourself to OpenAlex (the polite pool). Separate from the API key.
  • OPENALEX_BASE_URLOpenAlex API base URL.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Openalex MCP Server FAQ

Is Openalex MCP Server free?

Yes. Openalex MCP Server is open source, so you can use and self-host it for free.

How do I add Openalex MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http openalex-mcp-server https://openalex.caseyjhand.com/mcp