ArXiv

An MCP server for searching arXiv, downloading papers, reading bounded full text, retrieving original LaTeX by section, following citation graphs, and maintaining research alerts. It runs locally over stdio by default. Papers and indexes stay on your machine; search, source retrieval, citation graphs, and downloads call their respective external services. The command-based integrations require[uv, which provides`uvx`. Choose your client below; no repository clone or Python environment setup is required. ``` `claude mcp add --transport stdio --scope user arxiv -- uvx arxiv-mcp-server` ``` For the richer plugin integration—which installs the MCP connection plus the bundled arXiv research skill—register this repository as a marketplace and install the plugin: ``` `claude plugin marketplace add blazickjp/arxiv-mcp-server claude plugin install arxiv-mcp-server@arxiv-mcp` ``` Verify the direct MCP installation with`claude mcp get arxiv`. Restart Claude Code or run`/reload-plugins`after installing the plugin. ``` `codex mcp add arxiv -- uvx arxiv-mcp-server` ``` Or install the MCP connection and bundled research skill as a Codex plugin: ``` `codex plugin marketplace add blazickjp/arxiv-mcp-server codex plugin add arxiv-mcp-server@arxiv-mcp` ``` Verify the direct MCP installation with`codex mcp get arxiv`. Codex CLI, the Codex IDE extension, and Codex in the ChatGPT desktop app share this MCP configuration. Add the server, approve the discovered tools, and test the saved connection: ``` `hermes mcp add arxiv --command uvx --args arxiv-mcp-server hermes mcp test arxiv` ``` Use the**Add to Kiro**,**Install in VS Code**, or**Install in VS Code Insiders**button above. For the richer Kiro Power integration, open the**Powers**panel, choose**Add Custom Power → Import power from GitHub**, and enter: ``` `https://github.com/blazickjp/arxiv-mcp-server` ``` The Power installs the MCP connection from`mcp.json`and adds focused arXiv research guidance. Kiro users who prefer manual configuration can place the generic configuration below in`.kiro/settings/mcp.json`for one workspace or`~/.kiro/settings/mcp.json`for all workspaces. macOS users can install a bundled`.mcpb`extension from the](https://docs.astral.sh/uv/getting-started/installation/)[latest GitHub release: - Apple Silicon:`arxiv-mcp-server-darwin-arm64-<version>.mcpb` - Intel:`arxiv-mcp-server-darwin-x86_64-<version>.mcpb` Double-click the bundle, drag it into Claude Desktop, or open**Settings → Extensions → Advanced settings → Install Extension…**. The bundle includes the server dependencies and requires CPython 3.11.x. Add this stdio configuration to clients that accept the`mcpServers`JSON shape, such as Claude Desktop and Kiro. Other clients may use a top-level`servers`object, TOML, or their own settings UI; consult the client's MCP documentation. ``` `{ "mcpServers": { "arxiv": { "type": "stdio", "command": "uvx", "args": ](https://github.com/blazickjp/arxiv-mcp-server/releases/latest)["arxiv-mcp-server"] } } }` ``` The default paper directory is`~/.arxiv-mcp-server/papers`. To choose another directory, append`"--storage-path", "/absolute/path/to/papers"`to`args`. For older papers that require PDF conversion, run the package with its PDF extra: ``` `{ "mcpServers": { "arxiv": { "type": "stdio", "command": "uvx", "args": [ "--from", "arxiv-mcp-server[pdf]", "arxiv-mcp-server" ] } } }` ``` The supported package is published on PyPI. An unrelated npm package uses the same name, so do not install this server with npm, pnpm, or`npx arxiv-mcp-server`. ### If an existing installation is missing newer tools `uvx`reuses cached tool environments. Force it to resolve the current PyPI release with a supported interpreter, then restart your MCP client: ``` `uvx --python 3.11 --refresh-package arxiv-mcp-server arxiv-mcp-server` ``` If your client still launches an older environment, add`"--python", "3.11"`before`"arxiv-mcp-server"`in its`args`array. Desktop applications do not always inherit the same`PATH`as your terminal. If`uvx arxiv-mcp-server`works in a terminal but the client reports that the server failed to connect, find the executable's absolute path: ``` `# Windows PowerShell (Get-Command uvx).Source` ``` Replace`"command": "uvx"`with the returned absolute path, then restart the client. Keep the`args`value unchanged. To place`arxiv-mcp-server`on your`PATH`instead of launching it through`uvx`: If the command is not immediately available, run`uv tool update-shell`and restart the terminal. Afterward, use`"command": "arxiv-mcp-server"`and omit the package name from`args`. The repository now packages the same MCP server and research skill for both major plugin systems: Direct MCP installation is the shortest path. Install the plugin when you also want the research workflow that steers the client toward focused searches, bounded reads, citation traversal, and section-level LaTeX retrieval. Ask your MCP client to call`search_papers`with: ``` `{ "query": "\"Kolmogorov-Arnold Networks\"", "categories": ["cs.LG", "cs.AI"], "max_results": 5, "sort_by": "date" }` ``` ``` `{ "paper_id": "2404.19756" }` ``` ``` `{ "paper_id": "2404.19756", "max_chars": 12000 }` ``` Then page through the cached content with`read_paper`: ``` `{ "paper_id": "2404.19756", "start": 0, "max_chars": 12000 }` ``` Large-content responses include`content_length`,`returned_chars`,`next_start`, and`is_truncated`. Pass`next_start`into the next call to continue reading. ``` `{ "paper_id": "1706.03762" }` ``` Get the first page of its section outline with`list_paper_latex_sections`: ``` `{ "paper_id": "1706.03762", "start": 0, "max_sections": 100 }` ``` Then call`get_paper_latex_section`using an ID from that outline: ``` `{ "paper_id": "1706.03762", "section_id": "3.2", "max_chars": 12000 }` ``` LaTeX archives are validated, size-limited, and cached locally before content is returned. Choose the install variant that matches the features you need: ``` `# Base server uv tool install arxiv-mcp-server # Base server plus PDF conversion uv tool install "arxiv-mcp-server[pdf]" # Base server plus local semantic search uv tool install "arxiv-mcp-server[pro]"` ``` If the base tool is already installed, reinstall the selected variant: ``` `uv tool install --force "arxiv-mcp-server[pdf]"` ``` The`pdf`extra installs`pymupdf4llm`and`pymupdf-layout`for papers without usable arXiv HTML. The`pro`extra adds local embedding dependencies for`semantic_search`and`reindex`; semantic search only operates on papers already downloaded to the configured storage directory. The server provides seven MCP prompt workflows. Prompt availability depends on the client; the server provides workflow instructions but does not run a separate model. For deployments where stdio is not practical: ``` `TRANSPORT=http HOST=127.0.0.1 PORT=8080 \ uvx arxiv-mcp-server --storage-path /absolute/path/to/papers` ``` ``` `$env:TRANSPORT = "http" $env:HOST = "127.0.0.1" $env:PORT = "8080" uvx arxiv-mcp-server --storage-path C:\absolute\path\to\papers` ``` ``` `{ "mcpServers": { "arxiv": { "type": "http", "url": "http://127.0.0.1:8080/mcp" } } }` ``` Cloud and load-balancer probes should GET`http://<host>:<port>/healthz`. It returns`200`with body`ok`once the HTTP server is listening. There is no separate`/ready`check: if the process is up, it is ready. The stdio transport has no HTTP endpoints. The server binds to`127.0.0.1`by default and enables MCP DNS-rebinding protection. If a reverse proxy exposes the server, keep the process on a private interface and provide authentication and network controls upstream. Use`ALLOWED_HOSTS`and`ALLOWED_ORIGINS`for the host and origin values forwarded by the proxy. Environment variable names are case-insensitive through Pydantic settings.`--storage-path`is a command-line option rather than an environment setting. Paper text and LaTeX are untrusted external content. A paper can contain text intended to manipulate an AI client into ignoring its instructions or calling unrelated tools. - Do not treat instructions found inside a paper as trusted commands. - Use client approval controls for shell, browser, filesystem, and messaging tools. - Review generated summaries before taking external actions. - Keep Streamable HTTP private unless authentication is provided upstream. See[SECURITY.mdfor the reporting policy and threat details. ``` `git clone https://github.com/blazickjp/arxiv-mcp-server.git cd arxiv-mcp-server uv sync --extra test --extra dev uv run pytest uv run black --check .` ``` Run the development checkout from an MCP client with: ``` `{ "mcpServers": { "arxiv-dev": { "command": "uv", "args": ](https://github.com/blazickjp/arxiv-mcp-server/blob/HEAD/SECURITY.md)[ "--directory", "/absolute/path/to/arxiv-mcp-server", "run", "arxiv-mcp-server" ] } } }` ``` Contributions are welcome. Read[CONTRIBUTING.mdbefore opening a pull request, and use](https://github.com/blazickjp/arxiv-mcp-server/blob/HEAD/CONTRIBUTING.md)[GitHub Issuesfor reproducible bugs or scoped feature proposals. Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category. Verified, tier-0 regulatory data for your AI: connect Claude, ChatGPT or Cursor to 850+ official sources across 50+ jurisdictions. A flexible service for searching and analyzing academic papers on arXiv. Read Australian Commonwealth law as it stood on any date back to 1901, and verify statute citations against the official Federal Register of Legislation. No API key. Search scientific papers with structured experimental data extracted from full-text studies. Returns 25+ fields per paper including methods, results, sample sizes, limitations, and quality scores. Search academic references from arXiv, DBLP, Semantic Scholar, and OpenAlex, and generate BibTeX entries. Search and access academic paper metadata from Crossref. Search and cite exact passages across complete classical and world-literature corpora. Anonymous, read-only, source-backed Buddhist scripture search, passage guidance, explanation, and one-time practice planning through four production MCP tools.](https://github.com/blazickjp/arxiv-mcp-server/issues)