Skip to main content
Glama
arXiv MCP Server

arXiv MCP Server

by Ray0907

get_recent

Read-only

Fetch recent arXiv papers for a category, optionally since an inclusive UTC date, with limits for result count and abstract length.

Instructions

Get newest submissions, optionally since an inclusive UTC date (no saved state).

Args:
	category: arXiv category code (default: 'cs.AI')
	count: Maximum papers returned, clamped to 1–50 (default: 10)
	abstract_max_chars: Abstract character cap; None keeps full text, 0 returns an empty abstract
	since: Inclusive YYYY-MM-DD submission date, through today in UTC; no future dates

Returns:
	Recent papers with total_results and has_more to disclose count-limited windows.
	For more results use search_advanced with category, date_from=since,
	sort_by='date_desc', and page/page_size.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_recent"
  }
}

Input Schema

NameRequiredDescriptionDefault
countNo
sinceNo
categoryNocs.AI
abstract_max_charsNo

Output Schema

NameRequiredDescriptionDefault
countYesNumber of papers returned
papersYesList of recent papers
categoryYesCategory code (e.g., 'cs.AI')
has_moreNoWhether the count limit omitted matching papers
category_nameYesFull category name
total_resultsNoTotal matches in the category/date window

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.6.0

TDQS

A4.4/5.0
Behavior4/5

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

Goes beyond the readOnlyHint/openWorldHint annotations by disclosing statelessness ('no saved state'), the clamping of count to 1-50, the no-future-dates boundary, and how total_results/has_more expose count-limited windows. This is meaningful operational context an agent could not infer from annotations alone.

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?

Front-loaded one-line summary, then structured Args and Returns blocks with no filler. Slightly padded by the Returns block explaining what an existing output schema already implies, but each line still carries actionable information.

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?

Low-complexity read tool with four optional parameters, all documented, plus a fallback path to search_advanced and a note on count-limited windows. An output schema already exists, so the Returns narrative is a bonus rather than a necessity; nothing essential is missing.

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

Parameters5/5

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

Schema description coverage is 0%, so the description carries the full burden and does so: every one of the four parameters is documented with type, default, and edge-case semantics (e.g. abstract_max_chars None keeps full text, 0 returns an empty abstract; since is inclusive YYYY-MM-DD through today in UTC).

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

Purpose5/5

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

States a specific verb and resource ('Get newest submissions') plus scope qualifiers (optional inclusive UTC date, no saved state). The named contrast with search_advanced makes it distinguishable from siblings without opening their schemas.

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

Usage Guidelines4/5

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

Explicitly routes the agent to search_advanced when more results are needed, even prescribing the arguments (category, date_from=since, sort_by='date_desc', page/page_size). It lacks an explicit when-not case against other siblings like search or get_papers, but the condition that selects the alternative is clear.

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