Tools Reference

All MCP tools support batching for efficiency. Search multiple queries, fetch multiple papers, get multiple nodes — in a single call.

searchPapers

Search for papers by keywords, topic, or author.

Batch limit: 15 queries per call

Parameters

Parameter	Type	Required	Description
`queries`	`string[]`	Yes	Search queries (max 15)
`limit`	`number`	No	Results per query (default: 15, max: 20)
`from`	`string`	No	Start date (YYYY-MM-DD)
`to`	`string`	No	End date (YYYY-MM-DD)

Example

{
  "queries": ["transformer attention", "self-attention mechanism"]
}

Response

{
  "results": [
    {
      "arxivId": "1706.03762",
      "title": "Attention Is All You Need",
      "authors": ["Ashish Vaswani", "Noam Shazeer", "..."],
      "tldr": "A new simple network architecture...",
      "citationCount": 159306
    }
  ]
}

getPaperOverview

Get paper structure: TOC, figures, tables, equations, and AI summaries.

Batch limit: 25 papers per call

Parameters

Parameter	Type	Required	Description
`arxivIds`	`string[]`	Yes	arXiv IDs (max 25)

Example

{
  "arxivIds": ["1706.03762", "2301.07041"]
}

Response

{
  "arxivId": "1706.03762",
  "title": "Attention Is All You Need",
  "abstract": "The dominant sequence transduction models...",
  "citation": {
    "bibtex": "@article{vaswani2017attention,\n  title={Attention Is All You Need},\n  author={Vaswani, Ashish and Shazeer, Noam and ...},\n  journal={arXiv preprint arXiv:1706.03762},\n  year={2017}\n}",
    "apa": "Vaswani, A., Shazeer, N., ... (2017). Attention Is All You Need. arXiv preprint arXiv:1706.03762."
  },
  "toc": [
    { "section": "1", "nodeId": "sec:1", "title": "Introduction", "summary": "..." }
  ],
  "figures": [{ "nodeId": "fig:1", "caption": "The Transformer architecture" }],
  "tables": [{ "nodeId": "tab:1", "caption": "Maximum path lengths..." }],
  "equations": [{ "nodeId": "eq:1", "preview": "Attention(Q,K,V) = ..." }]
}

The citation field provides ready-to-use BibTeX and APA citations — no need to format them yourself.

getNodes

Fetch content by node IDs OR by type. Use nodeIds for specific elements, or types to fetch all of a kind.

Batch limit: 10 papers per call, 10 nodes per paper

Parameters

Parameter	Type	Required	Description
`requests`	`array`	Yes	Array of paper requests
`requests[].arxivId`	`string`	Yes	arXiv ID
`requests[].nodeIds`	`string[]`	No	Specific node IDs to fetch
`requests[].types`	`string[]`	No	Node types to fetch ALL of

Provide either nodeIds OR types (or both). At least one is required.

Node Types

Type	Description
`section`	Sections and subsections
`equation`	Numbered equations
`equation_array`	Multi-line equations (align, gather, etc.)
`figure`	Figures with images and captions
`table`	Tables with data
`algorithm`	Algorithm blocks
`code`	Code listings
`math_env`	Theorems, lemmas, proofs, definitions

Node ID Formats

Type	Format	Example
Sections	`sec:N`	`sec:3.2.1`
Equations	`eq:N`	`eq:1`
Figures	`fig:N`	`fig:2`
Tables	`tab:N`	`tab:1`
Theorems	`thm:N`	`thm:1`
Lemmas	`lem:N`	`lem:2`
Definitions	`def:N`	`def:1`
Algorithms	`alg:N`	`alg:1`

Examples

Fetch by node IDs:

{
  "requests": [
    { "arxivId": "1706.03762", "nodeIds": ["sec:3.2.1", "eq:1", "fig:1"] }
  ]
}

Fetch all equations:

{
  "requests": [
    { "arxivId": "1706.03762", "types": ["equation"] }
  ]
}

Fetch all tables and figures:

{
  "requests": [
    { "arxivId": "1706.03762", "types": ["table", "figure"] }
  ]
}

Response

{
  "1706.03762": {
    "sec:3.2.1": {
      "type": "section",
      "title": "Scaled Dot-Product Attention",
      "content": "We call our particular attention..."
    },
    "eq:1": {
      "type": "equation",
      "latex": "\\mathrm{Attention}(Q,K,V) = ...",
      "numbering": "1"
    }
  }
}

getReferences

Get bibliography with Semantic Scholar enrichment.

Limit: 100 references per call

Parameters

Parameter	Type	Required	Description
`arxivId`	`string`	Yes	arXiv ID
`limit`	`number`	No	Max references (default: 100)
`offset`	`number`	No	Pagination offset

Example

{
  "arxivId": "1706.03762"
}

Response

{
  "references": [
    {
      "citeKey": "bahdanau2014neural",
      "arxivId": "1409.0473",
      "title": "Neural Machine Translation by Jointly Learning to Align and Translate",
      "authors": ["Dzmitry Bahdanau", "Kyunghyun Cho"],
      "year": 2014,
      "citationCount": 28451
    }
  ]
}

getCitations

Get forward citations — papers that cite the given paper.

Limit: 100 citations per call

Parameters

Parameter	Type	Required	Description
`arxivId`	`string`	Yes	arXiv ID
`limit`	`number`	No	Max citations (default: 100)
`offset`	`number`	No	Pagination offset

Example

{
  "arxivId": "1706.03762"
}

Response

{
  "citations": [
    {
      "arxivId": "1810.04805",
      "title": "BERT: Pre-training of Deep Bidirectional Transformers",
      "authors": ["Jacob Devlin", "Ming-Wei Chang", "..."],
      "published": "2018-10-11",
      "citationCount": 95421
    }
  ]
}

On this page