Skip to main content
Glama
arXiv MCP Server

arXiv MCP Server

by Ray0907

search

Read-only

Find arXiv papers by query, author, category, or sort order, then retrieve titles, abstracts, authors, and URLs.

Instructions

Search arXiv for papers matching the query.

Args:
	abstract_max_chars: Abstract character cap; None keeps full text, 0 returns an empty abstract
	query: Search query for arXiv papers (e.g., 'LLM', 'transformer architecture')
	category: Filter by arXiv category (e.g., 'cs.AI', 'cs.LG', 'stat.ML')
	author: Filter by author name
	sort_by: Sort order - 'relevance', 'date_desc', 'date_asc', 'updated_desc', 'updated_asc'
	page: Page number (default: 1)
	page_size: Results per page, max 50 (default: 25)

Returns:
	Search results with papers containing title, abstract, authors, and URLs

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "query": "<query>"
    },
    "name": "search"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNo
queryYes
authorNo
sort_byNorelevance
categoryNo
page_sizeNo
abstract_max_charsNo

Output Schema

NameRequiredDescriptionDefault
pageNoCurrent page number
queryYesThe search query used
papersYesList of papers
has_moreNoWhether more results exist
next_pageNoNext page number if has_more is True
page_sizeNoNumber of results per page
total_resultsYesTotal number of results found

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.6.0
    • addedInput schema / properties / abstract_max_chars
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Abstract Max Chars"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "Paper": {
      +      "description": "Represents an arXiv paper.",
      +      "properties": {
      +        "abstract": {
      +          "description": "Paper abstract",
      +          "title": "Abstract",
      +          "type": "string"
      +        },
      +        "authors": {
      +          "description": "List of authors",
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Authors",
      +          "type": "array"
      +        },
      +        "categories": {
      +          "description": "arXiv categories",
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Categories",
      +          "type": "array"
      +        },
      +        "comment": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Author comment",
      +          "title": "Comment"
      +        },
      +        "date_published": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Publication date",
      +          "title": "Date Published"
      +        },
      +        "date_updated": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Last updated date",
      +          "title": "Date Updated"
      +        },
      +        "doi": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "DOI",
      +          "title": "Doi"
      +        },
      +        "id_arxiv": {
      +          "description": "arXiv paper ID (e.g., '2301.00001')",
      +          "title": "Id Arxiv",
      +          "type": "string"
      +        },
      +        "journal_ref": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Journal reference as supplied by arXiv",
      +          "title": "Journal Ref"
      +        },
      +        "primary_category": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Primary arXiv category",
      +          "title": "Primary Category"
      +        },
      +        "title": {
      +          "description": "Paper title",
      +          "title": "Title",
      +          "type": "string"
      +        },
      +        "url_abstract": {
      +          "description": "URL to the abstract page",
      +          "title": "Url Abstract",
      +          "type": "string"
      +        },
      +        "url_pdf": {
      +          "description": "URL to the PDF",
      +          "title": "Url Pdf",
      +          "type": "string"
      +        },
      +        "version": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Version number from the feed ID",
      +          "title": "Version"
      +        }
      +      },
      +      "required": [
      +        "id_arxiv",
      +        "title",
      +        "abstract",
      +        "url_abstract",
      +        "url_pdf"
      +      ],
      +      "title": "Paper",
      +      "type": "object"
      +    }
      +  },
      +  "description": "Search result containing papers and metadata.",
      +  "properties": {
      +    "has_more": {
      +      "default": false,
      +      "description": "Whether more results exist",
      +      "title": "Has More",
      +      "type": "boolean"
      +    },
      +    "next_page": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "Next page number if has_more is True",
      +      "title": "Next Page"
      +    },
      +    "page": {
      +      "default": 1,
      +      "description": "Current page number",
      +      "title": "Page",
      +      "type": "integer"
      +    },
      +    "page_size": {
      +      "default": 25,
      +      "description": "Number of results per page",
      +      "title": "Page Size",
      +      "type": "integer"
      +    },
      +    "papers": {
      +      "description": "List of papers",
      +      "items": {
      +        "$ref": "#/$defs/Paper"
      +      },
      +      "title": "Papers",
      +      "type": "array"
      +    },
      +    "query": {
      +      "description": "The search query used",
      +      "title": "Query",
      +      "type": "string"
      +    },
      +    "total_results": {
      +      "description": "Total number of results found",
      +      "title": "Total Results",
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "query",
      +    "total_results",
      +    "papers"
      +  ],
      +  "title": "SearchResult",
      +  "type": "object"
      +}
  2. First observedv1.0.0

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare `readOnlyHint=true` and `openWorldHint=true`, so the agent knows this is a safe, open-world read. The description adds useful operational detail: pagination defaults (page 1), a hard cap (`page_size` max 50), the sort modes available, and the `abstract_max_chars` edge behavior where 0 yields an empty abstract. It does not disclose result ordering nuances, rate limits, or total-result counts, so it sits at adequate rather than rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The structure is front-loaded with a one-line purpose, then a scannable argument list, which is easy for an agent to parse. The closing 'Returns' block is redundant because an output schema already exists, and a few entries restate the parameter name without adding much.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a seven-parameter search tool with an output schema, the description covers the required basics: required `query`, optional filters, sorting, and pagination limits. The main gap is guidance on how this differs from `search_advanced` and how results are ranked or truncated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry parameter semantics, and it largely does: all seven parameters are explained, including non-obvious behavior for `abstract_max_chars` and the accepted `sort_by` values. It does not state the enum of valid sort strings as a formal constraint or clarify whether `category` and `author` accept multiple values, leaving some ambiguity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Search arXiv for papers matching the query.' An agent can immediately tell this is a paper-search tool. However, it never distinguishes itself from the sibling tool `search_advanced`, so the agent must infer which search variant to use.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description contains no when-to-use or when-not-to-use guidance. It never mentions `search_advanced`, `get_recent`, or `list_categories`, and it gives no conditions under which an agent should prefer this basic search over its siblings. The only usage signal is implicit in the parameter list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.