inspire-mcp-more

An extensible Model Context Protocol server for the public INSPIRE REST API.

It provides structured tools for literature, authors, DOI/arXiv/ORCID resolution, citation export, and the INSPIRE bibliography generator. Responses offer bounded detail levels so an MCP client can trade metadata completeness for model context size.

Requirements

• Python 3.11 or newer

• uv

Related MCP server: scholar-toolkit-mcp

Install

Install globally from a checkout:

uv tool install .

Install from Git:

uv tool install git+https://github.com/karuboniru/inspire-mcp

Run without a persistent install:

uvx --from git+https://github.com/karuboniru/inspire-mcp inspire-mcp

Run

The default transport is stdio:

inspire-mcp

For a local Streamable HTTP endpoint:

inspire-mcp --transport streamable-http --host 127.0.0.1 --port 8000

The endpoint is http://127.0.0.1:8000/mcp by default. Binding to a non-loopback address requires --allow-public-http; production deployments should add authentication and TLS in front of the server.

Example MCP host configuration:

{
  "mcpServers": {
    "inspire": {
      "command": "inspire-mcp"
    }
  }
}

Tools

The inspire://capabilities resource describes supported values and limits.

Detail levels

• compact: identity and discovery fields, optimized for model context.

• standard: research-oriented metadata with bounded author arrays.

• detailed: broad public metadata with explicit truncated_fields markers.

Large arrays are never byte-truncated. Use list_literature_authors and list_literature_references to retrieve them in pages.

Author searches never expose email addresses. A single author record requires both detail="detailed" and include_email=true before public email fields are included.

Configuration

INSPIRE documents an upstream limit of 15 requests per 5 seconds per IP. This server uses a lower default to preserve headroom and retries HTTP 429 responses conservatively.

Successful GET, search, and export responses are cached in each server process. Concurrent identical requests share one upstream request. Set INSPIRE_CACHE_TTL_SECONDS=0 to disable the cache. Multi-process deployments maintain one independent cache per worker.

Generated bibliography content is currently served by INSPIRE through CERN object storage. The default download allowlist therefore contains both inspirehep.net and the exact host s3.cern.ch; arbitrary external download hosts remain blocked.

Development

uv sync --all-groups
uv run ruff check .
uv run mypy
uv run pytest
uv build

The default tests use mocked HTTP responses. Live INSPIRE POST requests are not performed by the test suite.

INSPIRE terms

Use of the upstream API is governed by the INSPIRE terms of use. Bulk collection of email addresses is not allowed.