{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tpxz7amktf36","handle":"arxiv-mcp-aj","url":"https://wellknown.network/agents/arxiv-mcp-aj","links":{"self":"https://wellknown.network/agents/arxiv-mcp-aj/record.json","html":"https://wellknown.network/agents/arxiv-mcp-aj","markdown":"https://wellknown.network/agents/arxiv-mcp-aj/record.md","api":"https://wellknown.network/api/v1/agents/arxiv-mcp-aj","status":"https://wellknown.network/api/v1/agents/arxiv-mcp-aj/status","claim":"https://wellknown.network/agents/arxiv-mcp-aj/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/arxiv-mcp-aj/claim.json","badge":"https://wellknown.network/agents/arxiv-mcp-aj/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/arxiv-mcp-aj/history","tools":"https://wellknown.network/api/v1/agents/arxiv-mcp-aj/tools"},"ard":{"identifier":"urn:air::server:arxiv-mcp-aj","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"arxiv-mcp-aj","summary":"Model Context Protocol server for arXiv PDF retrieval and LLM context generation.","description":"# arxiv-mcp \n \n> A production-grade Model Context Protocol server for autonomous arXiv paper retrieval, PDF extraction, and LLM-ready context preparation. \n \n--- \n \n## Table of Contents \n \n1. [System Architecture](#1-system-architecture) \n2. [Installation & Setup](#2-installation--setup) \n3. [Dependency Management](#3-dependency-management) \n4. [MCP Configuration](#4-mcp-configuration) \n5. [Tool Interface Definitions](#5-tool-interface-definitions) \n6. [End-to-End Workflow](#6-end-to-end-workflow) \n7. [Full Implementation Reference](#7-full-implementation-reference) \n8. [Example Usage](#8-example-usage) \n9. [Rate Limiting & arXiv API Constraints](#9-rate-limiting--arxiv-api-constraints) \n10. [Error Handling](#10-error-handling) \n11. [Troubleshooting](#11-troubleshooting) \n \n--- \n \n## 1. System Architecture \n \n```mermaid \nflowchart TB \n    subgraph CLIENTS[\"🖥️ MCP Clients\"] \n        direction LR \n        C1[\"VS Code\\nMCP client\"] \n        C2[\"Cursor\\nMCP client\"] \n        C3[\"Claude Desktop\\nMCP client\"] \n        C4[\"Agent / SDK\\nMCP client\"] \n    end \n \n    TRANSPORT[\"/stdio / SSE transport/\"] \n \n    subgraph SERVER[\"⚙️ MCP Server Core — server.py\"] \n        SR[\"Tool Registry · Request Router · Error Boundary · Rate-limit Guard\"] \n    end \n \n    subgraph MODULES[\"🔧 Core Modules\"] \n        direction LR \n        M1[\"arXiv Client\\n──────────\\nSearch · Validate\\nRate limit · Cache\"] \n        M2[\"PDF Fetcher\\n──────────\\nDownload · Validate\\nCache · Retry\"] \n        M3[\"PDF Parser\\n──────────\\nPyMuPDF · pdfminer\\nSections · Clean\"] \n        M4[\"Context Builder\\n──────────\\nChunk · Prioritize\\nToken budget · Format\"] \n    end \n \n    subgraph EXTERNAL[\"🌐 External Systems\"] \n        direction LR \n        E1[\"arXiv Atom API\\nexport.arxiv.org\"] \n        E2[\"PDF Storage\\narxiv.org/pdf/…\"] \n        E3[\"PyMuPDF\\n+ pdfminer fallback\"] \n        E4[\"tiktoken\\ncl100k_base\"] \n    end \n \n    subgraph CROSSCUT[\"🛡️ Cross-Cutting Concerns\"] \n        direction LR \n        X1[\"Cache L…","publisher":{"name":"arxiv MCP Team","url":null},"homepage":"https://github.com/Aldrin-Joan/arXiv-mcp","repository":"https://github.com/Aldrin-Joan/arXiv-mcp","version":"0.1.3","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:arxiv-mcp-aj","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"research.academic","name":"Academic Research","confidence":1,"provenance":"derived"}],"categories":["research"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"arxiv-mcp-aj","registry":"pypi","observedAt":"2026-10-21T17:28:01.594Z","publishedAt":"2026-03-21T02:18:47.259922Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"arxiv-mcp-aj","url":"https://pypi.org/project/arxiv-mcp-aj/","firstSeenAt":"2026-09-09T09:23:47.856Z","fetchedAt":"2026-10-21T17:26:26.555Z","normalizedAt":"2026-10-21T17:26:26.555Z"}]},"firstSeenAt":"2026-09-09T09:23:47.856Z","updatedAt":"2026-10-21T17:28:01.594Z"}