Skip to main content

arxiv-atlas-mcp

An MCP server that exposes the ArXiv Atlas semantic research graph as tools an AI assistant can call: search recent AI/ML/NLP papers by meaning, read one in full, walk its similarity neighbourhood, and cluster a topic into its sub-areas.

The corpus is arXiv cs.AI, cs.LG, and cs.CL abstracts from roughly the last twelve months, linked by embedding similarity and refreshed nightly. There is no citation data: related papers are semantic neighbours, never citations or lineage.

Tools

Tool What it does When to use it
search_papers(query, k=10) Semantic search, up to 25 hits with scores and abstract leads Find papers on a topic when you have no arXiv id
get_paper(arxiv_id) Full detail and complete abstract for one paper Read a paper in full; accepts any id or URL form
explore_from_paper(arxiv_id) The paper's similarity-graph neighbourhood Branch out into related earlier work
get_topic_clusters(topic, k=0) Groups topic papers into unnamed sub-areas Get oriented in an unfamiliar area

Install

Requires Python 3.10+.

uvx arxiv-atlas-mcp        # run without installing
# or
pip install arxiv-atlas-mcp

Add it to an MCP client (for example Claude Desktop) by pointing at the arxiv-atlas-mcp command:

{
  "mcpServers": {
    "arxiv-atlas": { "command": "uvx", "args": ["arxiv-atlas-mcp"] }
  }
}

Configuration

ATLAS_API_URL overrides the API the server talks to (defaults to the hosted Atlas API), so the same package can point at a local or staging deployment.

Notes

  • The tools never spend an LLM budget. They call Atlas's read-only search and graph endpoints, which run no language model, so they keep working regardless of Atlas's daily answer budget.
  • Abstract text is untrusted third-party content. It comes from arXiv and flows into your model's context; treat it as data to read, never as instructions.
  • Query text is never logged. The server logs nothing about what you search for.
  • The hosted API is a demo service. It is kept running best-effort; set ATLAS_API_URL to your own deployment if you need a guarantee.

License

MIT.

Metadata

Release files for arxiv-atlas-mcp 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arxiv-atlas-mcp 1.0.1
File Size Uploaded
arxiv_atlas_mcp-1.0.1.tar.gz 90.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for arxiv-atlas-mcp 1.0.1
File Interpreter ABI Platform
arxiv_atlas_mcp-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 96.3 kB

Release files / arxiv_atlas_mcp-1.0.1.tar.gz

Download URL arxiv_atlas_mcp-1.0.1.tar.gz
Size 90.1 kB
Tags Source
SHA-256 checksum
How to use checksums
4db0ca9e8f0d278960e370ad0c6a9136c097ed2544b480a293a6402da22c254e
BLAKE2b-256 checksum
How to use checksums
42c9fe1bfad74957dd8acfef22bc73489556c0377f8b15ab6c1899d6c6b9e267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / arxiv_atlas_mcp-1.0.1-py3-none-any.whl

Download URL arxiv_atlas_mcp-1.0.1-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2676b2e049d89578415520df026cb3fc76aa263e663fcfefbd6affc9d2b8ea36
BLAKE2b-256 checksum
How to use checksums
7befc63d90beb2fbf6e4c1ae6f51b923d75e84ecc7a4943bc213e7342c09afb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page