InspireHEP MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| INSPIREHEP_CACHE_TTL | No | Cache TTL in seconds (24h) | 86400 |
| INSPIREHEP_LOG_LEVEL | No | Logging level | INFO |
| INSPIREHEP_API_TIMEOUT | No | HTTP request timeout (seconds) | 30 |
| INSPIREHEP_CACHE_DB_PATH | No | SQLite cache file path | inspirehep_cache.db |
| INSPIREHEP_CACHE_MAX_SIZE | No | Max cached entries | 512 |
| INSPIREHEP_CACHE_PERSISTENT | No | Enable SQLite persistent cache | false |
| INSPIREHEP_REQUESTS_PER_SECOND | No | API rate limit | 1.5 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingA | Check that the InspireHEP MCP server is running. |
| server_statsA | Return cache and request performance statistics for the server. Useful for monitoring cache hit rates, request counts, and average response times. No parameters required. |
| search_papersB | Search InspireHEP for papers matching a query. Supports free-text and field-specific queries such as:
Args: query: Search query string. sort: Sort order — "bestmatch", "mostrecent", or "mostcited". size: Number of results to return (1-100, default 10). |
| get_paper_detailsA | Retrieve detailed metadata for a specific paper. Provide at least one identifier. Accepts multiple formats:
Returns title, authors, abstract, citations, references count, publication info, keywords, URLs, and more. |
| get_paper_figuresA | Retrieve figures for a specific paper. Provide at least one identifier. Accepts multiple formats:
Returns title, inspire url, and a list of figures with their captions, descriptions and direct download URLs. |
| get_author_papersA | Retrieve publication history and citation metrics for an author. Provide either author_name or author_id:
Returns a list of papers plus aggregate metrics including total citations, h-index, and average citations per paper. Args: author_name: Author name in "Last, First" format. author_id: InspireHEP author identifier (BAI). sort: Sort order — "mostrecent" or "mostcited". size: Number of papers to return (1-100, default 20). |
| get_citationsA | Retrieve citation graph data for a paper. Args: inspire_id: InspireHEP record ID (numeric). direction: "citing" (papers that cite this) or "cited_by" (papers this cites). size: Number of results to return (1–250, default 50). Returns citation list with metadata, total count, and a year-by-year citation timeline. |
| search_by_collaborationA | Find publications from a specific experimental collaboration. Handles common name variations (e.g. "lhcb" → "LHCb"). Args: collaboration_name: Collaboration name (e.g. "ATLAS", "CMS", "LHCb", "Belle-II"). sort: Sort order — "mostrecent" or "mostcited". size: Number of results to return (1–100, default 20). year: Optional year filter (e.g. 2024). Returns publication list, year distribution, total citations, and top-cited papers from the returned set. |
| get_referencesA | Generate a formatted reference list for a paper. Args: inspire_id: InspireHEP record ID (numeric). format: Output format — "bibtex", "json", "latex-us", or "latex-eu". Returns the reference list in the requested format along with total reference count and paper title. |
| get_bibtexA | Retrieve the BibTeX citation entry for a paper. Accepts any common identifier format:
Args: identifier: A DOI, arXiv ID, or InspireHEP record ID. Returns the BibTeX entry along with paper title, texkey, and the resolved Inspire record ID. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/MohamedElashri/inspirehep-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server