Skip to main content
Glama
MohamedElashri

InspireHEP MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
INSPIREHEP_CACHE_TTLNoCache TTL in seconds (24h)86400
INSPIREHEP_LOG_LEVELNoLogging levelINFO
INSPIREHEP_API_TIMEOUTNoHTTP request timeout (seconds)30
INSPIREHEP_CACHE_DB_PATHNoSQLite cache file pathinspirehep_cache.db
INSPIREHEP_CACHE_MAX_SIZENoMax cached entries512
INSPIREHEP_CACHE_PERSISTENTNoEnable SQLite persistent cachefalse
INSPIREHEP_REQUESTS_PER_SECONDNoAPI rate limit1.5

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  • "dark matter direct detection"

  • "author:ellis title:higgs"

  • "collaboration:ATLAS supersymmetry"

  • "find a weinberg and t electroweak"

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:

  • inspire_id: "3456"

  • arxiv_id: "arxiv:2301.12345", "arxiv:hep-ph/0123456", or full URL

  • doi: "10.1103/PhysRevLett.123.456789" or full URL

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:

  • inspire_id: "3456"

  • arxiv_id: "arxiv:2301.12345", "arxiv:hep-ph/0123456", or full URL

  • doi: "10.1103/PhysRevLett.123.456789" or full URL

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:

  • author_name: "Weinberg, Steven" (Last, First format)

  • author_id: "S.Weinberg.1" (InspireHEP BAI)

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:

  • Inspire ID: "3456"

  • arXiv ID: "arxiv:2301.12345", "arxiv:hep-ph/0123456", or full URL

  • DOI: "10.1103/PhysRevLett.123.456789" or full URL

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

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