
Arxiv Mcp
- 109 installs
- 36 repo stars
- Updated July 14, 2026
- oimiragieo/agent-studio
Query arXiv papers, summaries, and citations inside agent workflows when validating ML ideas, drafting literature reviews, or grounding RAG answers in primary sources.
About
arxiv-mcp exposes arXiv as an MCP tool so coding agents can search, fetch, and reason over academic papers during early research. It supports literature reviews, method comparison, and citation gathering without manual browsing, keeping ML and AI product exploration evidence-based from the first conversation.
- MCP-native arXiv search and retrieval
- Literature review inside agent chats
- Citation-ready paper metadata
- Grounds AI features in published work
- Speeds validate-before-build decisions
Arxiv Mcp by the numbers
- 109 all-time installs (skills.sh)
- Ranked #4,092 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/oimiragieo/agent-studio --skill arxiv-mcpAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 109 |
|---|---|
| repo stars | ★ 36 |
| Last updated | July 14, 2026 |
| Repository | oimiragieo/agent-studio ↗ |
What it does
Query arXiv papers, summaries, and citations inside agent workflows when validating ML ideas, drafting literature reviews, or grounding RAG answers in primary sources.
Files
Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.
arXiv Search Skill
<identity> arXiv Search Skill - Search and retrieve academic papers from arXiv.org using existing tools (WebFetch, Exa). No MCP server installation required. </identity>
✅ No Installation Required
This skill uses existing tools to access arXiv:
- WebFetch - Direct access to arXiv API
- Exa - Semantic search with arXiv filtering
Works immediately - no MCP server, no restart needed.
<capabilities>
- Search academic papers by keywords, authors, categories, or date ranges
- Retrieve detailed paper metadata (title, authors, abstract, categories, PDF link)
- Get specific papers by arXiv ID
- Find related papers based on categories and keywords
- Filter by arXiv categories (cs.AI, cs.LG, cs.CV, math., physics., etc.)
- No API key required - uses public arXiv API
</capabilities>
Result Limits (Memory Safeguard)
arxiv-mcp returns academic papers. To prevent memory exhaustion:
- max_results: 20 (HARD LIMIT)
- Each paper metadata ~300 bytes
- 20 papers × 300 bytes = ~6 KB metadata
- Papers can be 100+ KB each if fetched - DON'T fetch full papers
Why the limit?
- Previous limit: 100 results → 30 KB+ metadata → context explosion
- New limit: 20 results → 6 KB metadata → memory safe
- 20 papers is usually enough to find your target
<instructions> <execution_process>
Method 1: WebFetch with arXiv API (Recommended for specific queries)
The arXiv API is publicly accessible at http://export.arxiv.org/api/query.
Recommended Pattern
// ✓ GOOD: Limit results to 20
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=all:transformer+attention&max_results=20&sortBy=relevance',
prompt: 'Extract paper titles, authors, abstracts, arXiv IDs, and PDF links from these results',
});
// ✓ GOOD: Use specific filters to reduce result set
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=all:transformer+attention+2025&max_results=20&sortBy=submittedDate',
prompt: 'Extract recent papers on transformer attention',
});
// ✗ BAD: Old behavior - unlimited or >20 results
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=all:neural+networks',
// Too broad - will get 100s of results
});
// ✗ BAD: Exceeds memory limit
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=all:deep+learning&max_results=100',
// Over limit - memory risk
});Search by Keywords
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=all:transformer+attention&max_results=20&sortBy=relevance',
prompt: 'Extract paper titles, authors, abstracts, arXiv IDs, and PDF links from these results',
});Search by Author
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=au:LeCun&max_results=10&sortBy=submittedDate',
prompt: 'Extract paper titles, authors, abstracts, and arXiv IDs',
});Search by Category
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=cat:cs.LG&max_results=15&sortBy=submittedDate',
prompt: 'Extract paper titles, authors, abstracts, categories, and arXiv IDs',
});Get Specific Paper by ID
WebFetch({
url: 'http://export.arxiv.org/api/query?id_list=2301.07041',
prompt:
'Extract full details: title, all authors, abstract, categories, published date, PDF link',
});API Query Parameters
| Parameter | Description | Example |
|---|---|---|
search_query | Search terms with field prefixes | all:transformer, au:LeCun, ti:attention |
id_list | Comma-separated arXiv IDs | 2301.07041,2302.13971 |
max_results | Number of results (default 10, max 100) | max_results=20 |
start | Offset for pagination | start=10 |
sortBy | Sort order: relevance, lastUpdatedDate, submittedDate | sortBy=submittedDate |
sortOrder | ascending or descending | sortOrder=descending |
Field Prefixes for search_query
| Prefix | Field | Example |
|---|---|---|
all: | All fields | all:machine+learning |
ti: | Title | ti:transformer |
au: | Author | au:Vaswani |
abs: | Abstract | abs:attention+mechanism |
cat: | Category | cat:cs.LG |
co: | Comment | co:accepted |
Boolean Operators
Combine terms with AND, OR, ANDNOT:
search_query=ti:transformer+AND+abs:attention
search_query=au:LeCun+OR+au:Bengio
search_query=cat:cs.LG+ANDNOT+ti:surveyWhen NOT to Use arxiv-mcp
- General web research → Use WebSearch/WebFetch instead
- Implementation examples → Use
pnpm search:codeor ripgrep skill on codebase (Grep/Glob as fallback) - Product research → Use WebSearch with news filter
- Community discussions → Use WebSearch for forums/Stack Overflow
arxiv-mcp is best for:
- Finding academic papers on specific topics
- Understanding theoretical foundations
- Citing research in documentation
- Quick literature review (20 papers max)
---
Method 2: Exa Search (Better for semantic/natural language queries)
Use Exa for more natural language queries with arXiv filtering:
Semantic Search
mcp__Exa__web_search_exa({
query: 'site:arxiv.org transformer architecture attention mechanism deep learning',
numResults: 10,
});Recent Papers in a Field
mcp__Exa__web_search_exa({
query: 'site:arxiv.org large language model scaling laws 2024',
numResults: 15,
});Author-Focused Search
mcp__Exa__web_search_exa({
query: 'site:arxiv.org author:"Yann LeCun" deep learning',
numResults: 10,
});---
Common arXiv Categories
| Category | Field |
|---|---|
| cs.AI | Artificial Intelligence |
| cs.LG | Machine Learning |
| cs.CL | Computation and Language (NLP) |
| cs.CV | Computer Vision |
| cs.SE | Software Engineering |
| cs.CR | Cryptography and Security |
| stat.ML | Machine Learning (Statistics) |
| math.\* | Mathematics (all subcategories) |
| physics.\* | Physics (all subcategories) |
| q-bio.\* | Quantitative Biology |
| econ.\* | Economics |
---
Workflow: Complete Research Process
Step 1: Initial Search
// Start with broad Exa search for semantic matching
mcp__Exa__web_search_exa({
query: 'site:arxiv.org transformer attention mechanism neural networks',
numResults: 10,
});Step 2: Get Specific Papers
// Get details for interesting papers by ID
WebFetch({
url: 'http://export.arxiv.org/api/query?id_list=2301.07041,2302.13971',
prompt: 'Extract full metadata for each paper: title, authors, abstract, categories, PDF URL',
});Step 3: Find Related Work
// Search by category of interesting paper
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=cat:cs.LG+AND+ti:attention&max_results=10&sortBy=submittedDate',
prompt: 'Find related papers, extract titles and abstracts',
});Step 4: Get Recent Papers
// Latest papers in the field
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=cat:cs.LG&max_results=20&sortBy=submittedDate&sortOrder=descending',
prompt: 'Extract the 20 most recent machine learning papers',
});</execution_process>
<best_practices>
1. Use Exa for discovery: Natural language queries find semantically related papers 2. Use WebFetch for precision: Specific IDs, categories, or API queries 3. Combine approaches: Exa to discover, WebFetch to deep-dive 4. Use specific queries: "transformer attention mechanism" > "machine learning" 5. Check multiple categories: Papers often span cs.AI + cs.LG + cs.CL 6. Sort by date for recent work: sortBy=submittedDate&sortOrder=descending
</best_practices> </instructions>
<examples> <usage_example> Example 1: Search for transformer papers:
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=ti:transformer+AND+abs:attention&max_results=10&sortBy=relevance',
prompt: 'Extract paper titles, authors, abstracts, and arXiv IDs',
});Example 2: Find papers by researcher:
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=au:Vaswani&max_results=15',
prompt: 'List all papers by this author with titles and dates',
});Example 3: Get recent ML papers:
WebFetch({
url: 'http://export.arxiv.org/api/query?search_query=cat:cs.LG&max_results=20&sortBy=submittedDate&sortOrder=descending',
prompt: 'Extract the 20 most recent machine learning papers with titles and abstracts',
});Example 4: Semantic search with Exa:
mcp__Exa__web_search_exa({
query: 'site:arxiv.org multimodal large language models vision 2024',
numResults: 10,
});Example 5: Get specific paper details:
WebFetch({
url: 'http://export.arxiv.org/api/query?id_list=1706.03762',
prompt: "Extract complete details for the 'Attention Is All You Need' paper",
});</usage_example> </examples>
Agent Integration
This skill is automatically assigned to:
- researcher - Academic research, literature review
- scientific-research-expert - Deep scientific analysis
- developer - Finding technical papers for implementation
Iron Laws
1. ALWAYS enforce max_results=20 — never allow unlimited or >20 result queries; context explosion from 100+ papers is a known failure mode that stalls agent pipelines. 2. NEVER fetch full paper PDFs during literature review — extract metadata and abstracts only; full papers are 100KB+ each and will exhaust context budget in minutes. 3. ALWAYS use Exa for semantic discovery, WebFetch for precision retrieval — Exa finds semantically related papers; WebFetch gets specific IDs or category feeds; use both in sequence, not interchangeably. 4. NEVER use broad queries without field prefixes — search_query=neural+networks returns thousands of results; always scope with ti:, au:, cat:, or abs: prefixes to target the query. 5. ALWAYS cite arXiv IDs (e.g., 2301.07041) when referencing papers — titles alone are ambiguous and change; IDs are stable, machine-readable, and enable instant retrieval.
Anti-Patterns
| Anti-Pattern | Why It Fails | Correct Approach |
|---|---|---|
Using max_results=100 or no limit | Context explosion; 100 papers × 300 bytes = 30KB+ metadata | Always set max_results=20 (hard limit) |
| Fetching full paper PDFs | Single paper can be 100KB+; kills context budget | Extract abstract + metadata only via API |
| Broad query without field prefix | Returns irrelevant results across all fields | Use ti:, au:, cat:, or abs: prefix |
| Using only WebFetch for discovery | Misses semantically related papers not matching exact terms | Use Exa for semantic discovery first |
| Citing paper titles instead of arXiv IDs | Titles can be ambiguous or duplicated | Always include the arXiv ID (e.g., 1706.03762) |
Memory Protocol (MANDATORY)
Before starting:
cat .claude/context/memory/learnings.mdAfter completing:
- New pattern ->
.claude/context/memory/learnings.md - Issue found ->
.claude/context/memory/issues.md - Decision made ->
.claude/context/memory/decisions.md
ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.
Invoke the arxiv-mcp skill and follow it exactly as presented to you
'use strict';
/**
* Post-execute hook for arxiv-mcp
* Auto-generated by enterprise-bundle-scaffolder
*
* Records metrics after skill execution.
*/
function postExecute(_context) {
// Record execution metrics
return { ok: true, skill: 'arxiv-mcp' };
}
module.exports = { postExecute };
'use strict';
/**
* Pre-execute hook for arxiv-mcp
* Auto-generated by enterprise-bundle-scaffolder
*
* Validates inputs before skill execution.
*/
function preExecute(context) {
// Validate skill invocation context
if (!context || typeof context !== 'object') {
return { allow: true, message: 'arxiv-mcp: no context to validate' };
}
return { allow: true };
}
module.exports = { preExecute };
https://github.com/1Dark134/arxiv-mcp-server/releases
arxiv-mcp-server: AI MCP for arXiv paper search and exports
    
Welcome to arxiv-mcp-server. This project hosts an MCP server for arXiv.org. It helps researchers find papers, analyze citations, track trends, and export data in multiple formats. It blends intelligent discovery with robust data processing so you can focus on research, not data wrangling.
Key ideas you should know:
- It centers on Model Context Protocol (MCP) to coordinate paper data and AI assistants.
- It offers advanced search, discovery, and analysis workflows for academic papers.
- It exports results to several formats for use in other tools.
Topics
- academic-papers
- academic-research
- ai-assistant
- arxiv
- citation-analysis
- mcp
- model-context-protocol
- paper-search
- research-automation
- research-tools
Table of contents
- Overview
- Features
- Quick start
- Installation
- Architecture
- Data model and formats
- How MCP works here
- AI assistants and prompts
- Paper discovery and search
- Citation analysis and trends
- Exports and formats
- API and CLI
- UI and UX
- Docker and deployment
- Security, privacy, and compliance
- Testing and quality
- Development and contribution
- Roadmap
- Releases and versioning
- FAQ
- License and credits
Overview 🚀 arxiv-mcp-server is a scalable server for arXiv.org data. It combines fast search with smart analysis. It uses AI assistants to interpret papers, summarize findings, and propose next steps. The server can export results in BibTeX, RIS, JSON, CSV, and more. It supports multi-format workflows and can power web apps, notebooks, and research dashboards.
This project is built to be reliable in research settings. It favors clarity, reproducibility, and security. It aims to help researchers assemble literature reviews, identify citation patterns, and monitor evolving topics over time.
Features 🧠
- Advanced paper discovery: semantic search, topic modeling, and trend tracking.
- Citation analysis: citation networks, author influence, venue impact, and hot topics.
- AI assistants: guided summaries, question answering, and context-aware recommendations.
- Multi-format exports: BibTeX, EndNote, RIS, YAML, JSON, CSV, and PDF-ready summaries.
- MCP-driven architecture: clear data contracts between components and AI agents.
- Extensible data model: supports custom fields, plugins, and adapters for new data sources.
- REST API and CLI: programmatic access and automation.
- Local-first deployment: runs on a single machine or in a cloud cluster.
- Reproducible pipelines: rigorous logging, provenance, and versioning.
Quick start ⚡
- Get a feel for what it does by trying a quick run with a release artifact.
- Download the latest release from the releases page and run the installer or package for your platform.
- Start small: fetch a subset of arXiv papers, run a few analyses, and export results.
Downloads and releases
- The latest releases page contains ready-to-run artifacts for Windows, macOS, and Linux. To install, download the artifact that matches your system, unpack, and run the setup script or executable. See https://github.com/1Dark134/arxiv-mcp-server/releases for details. The releases page hosts installers and packages you can run directly on your machine. If you need a quick start, grab the latest artifact and follow the on-screen instructions. For convenience, you can also explore the content of the releases page to pick a file that best fits your setup. You can visit the releases page again at https://github.com/1Dark134/arxiv-mcp-server/releases.
Installation 🧰
- Prerequisites
- Operating system: Linux, macOS, or Windows.
- Minimum Python/Node versions depending on the chosen runtime (see installation guide in the docs).
- Sufficient disk space for paper data and indices.
- Network access for fetching arXiv data and for updates.
- Quick install (Linux/macOS)
- Download the release artifact for your platform from the releases page.
- Extract the package to a directory of your choice.
- Run the installer or setup script provided in the package.
- Follow on-screen prompts to configure database paths, API keys, and AI settings.
- Quick install (Windows)
- Download the Windows artifact from the releases page.
- Run arxiv-mcp-server-windows-setup.exe (or equivalent).
- Complete the setup wizard and choose installation options.
- Docker quick start
- Use the official Docker image to spin up a container with a single command.
- Example:
- docker run --rm -it -p 8080:8080 arxiv-mcp-server:latest
- This runs the MCP server and exposes its API on port 8080. You can connect to the API or the UI from your browser.
- Post-install checks
- Confirm the service is listening on the expected port.
- Check logs for startup messages, errors, or configuration guidance.
- Verify a basic search query returns a result set.
Architecture and design 🏗
- Core components
- Data ingestor: fetches papers from arXiv and other sources.
- Indexer: builds search indexes for fast retrieval.
- MCP core: enforces the model-context contracts and internal data flows.
- AI assistant layer: provides prompts, context assembly, and response shaping.
- API layer: exposes REST endpoints for apps and scripts.
- UI layer: a web interface for humans to explore papers and insights.
- Export engine: converts data into BibTeX, RIS, JSON, CSV, and other formats.
- Data flow
- Ingest data from arXiv feeds.
- Normalize and store in a structured data store.
- Run analyses, generate context for AI assistants, and produce exports.
- Serve results to clients via API or UI.
- Extensibility
- Plugins and adapters allow new data sources and export formats.
- Custom prompts and AI models can be plugged into the assistant layer.
- Configurable pipelines let you tailor discovery and analysis workflows.
Data model and formats 🗃
- Core entities
- Paper: identifier, title, authors, abstract, categories, dates, DOI, and arXiv metadata.
- Author: name, affiliations, ORCID, and citation metrics.
- Venue: conference or journal details, venue impact, and citations.
- Citation: relationships between papers, context, and inline references.
- TopicModel: topics and their weights per paper.
- ExportBundle: a collection of papers and analyses prepared for export.
- Formats supported
- BibTeX: standard bibliographic format for LaTeX workflows.
- RIS: popular import/export format for reference managers.
- EndNote: rich-format export for EndNote users.
- JSON: structured data for programmatic use.
- CSV: tabular data for spreadsheets and dashboards.
- YAML: human-friendly configuration and data interchange.
- PDF-ready summaries: generate concise abstracts and highlights for printing.
- Data provenance
- Every paper entry records its source, ingestion time, and version.
- Analyses keep a record of the prompts used and model versions.
Model Context Protocol (MCP) in this project 🔗
- MCP is a contract that coordinates data, prompts, and AI agents.
- The MCP core ensures consistent context sharing between components.
- This design helps keep prompts deterministic and repeatable.
- It also enables easier swapping of AI backends without breaking the workflow.
- You can extend the MCP schema to add new fields for context, prompts, and outputs.
AI assistants and prompts 🤖
- Assistants
- Research Summarizer: creates concise, structured summaries of papers.
- Trend Reporter: tracks topic trends over time and highlights shifts.
- Citation Drill-Down: analyzes citation networks and influential works.
- Question Answerer: answers user questions using contextual paper data.
- Prompt design
- Prompts are modular and contextual. They pull in a paper’s metadata, abstracts, and citations.
- Short prompts handle quick lookups; longer prompts produce in-depth analyses.
- Safety prompts ensure output remains within allowed usage and privacy rules.
- Context management
- Each analysis task receives a tailored context bundle.
- The system caches useful prompts and outputs to speed up repeated queries.
Paper search and discovery 🔎
- Semantic search
- Uses embeddings to find papers by meaning, not just keywords.
- Supports keyword queries, filters, and facets (subject area, year, authors).
- Faceted discovery
- Browse by categories, authors, venues, or topics.
- Visualize discovered clusters and topic overlaps.
- Smart filters
- Time-based trends, author influence, and citation patterns.
- Filter by data quality or data source reliability.
- Recommendations
- Propose related papers based on context and user intent.
- Surface emerging topics and rising authors.
Citation analysis and trends 📈
- Citation networks
- Build directed graphs showing who cites whom.
- Identify influential papers and scholars.
- Author metrics
- h-index-like measures, venue impact, and collaboration patterns.
- Topic trends
- Track how topics rise and fall over years.
- Detect bursts in specific keywords or methods.
- Visualizations
- Network graphs, heatmaps, and timeline charts.
- Export visuals for reports and presentations.
Exports and formats 📤
- Export targets
- BibTeX, RIS, EndNote, JSON, CSV, YAML.
- PDF-ready summaries for quick reading.
- Custom export templates
- Create templates that match your journal or conference requirements.
- Save templates for reuse across projects.
- Export pipelines
- Pipeline steps can be chained: fetch → analyze → export → share.
- You can run exports on-demand or on a schedule.
- Data integrity
- Exports include provenance stamps and versioning.
- Checksums verify file integrity on transfer.
API and CLI 👩💻
- REST API
- Endpoints for search, paper details, analyses, and exports.
- Supports pagination, filters, and quick lookups.
- CLI
- Light-weight command line interface for automation.
- Examples:
- arxiv-mcp search --query "quantum computing" --limit 20
- arxiv-mcp analyze --paper-id 2103.XXXX
- arxiv-mcp export --format bibtex --ids 2103.XXXX,2104.XXXX
- Authentication
- API keys or OAuth for secure access.
- Role-based access to limit data exposure.
- SDKs
- Lightweight client libraries to connect from Python, Node, or shell scripts.
- Provide helper methods for common tasks like search and export.
UI and UX 💻
- Web interface
- Clean search bar with facets and filters.
- Paper detail pages with inline citations, summaries, and recommended readings.
- AI-assisted panels for summarization and questions.
- Visual dashboards
- Trends, networks, and topic maps.
- Exportable charts for reports.
- Accessibility
- Keyboard navigation, screen reader support, and high-contrast themes.
- Internationalization
- Basic translation layer for common languages.
- Right-to-left support for proper layout where required.
Deployment and environments 🚢
- Local development
- Use a lightweight setup to run a single-node instance.
- Mount data directories for persistent storage.
- Staging and production
- Deploy in a containerized environment with orchestration.
- Separate services for ingestion, analysis, API, and UI.
- Docker and Kubernetes
- Official Docker image and a compose file for quick starts.
- Kubernetes manifests for scalable deployments.
- Resource tuning
- Set limits for CPU, memory, and database connections.
- Fine-tune the search index and AI prompts for performance.
Security, privacy, and compliance 🛡
- Data handling
- Respect licenses of arXiv content and third-party data.
- Anonymize analysis reports where appropriate.
- Access control
- Enforce authentication for API usage.
- Audit logs for sensitive operations.
- Secrets and keys
- Store API keys and credentials securely using environment variables or secret managers.
- Updates and hardening
- Regularly apply patches and security updates.
- Follow minimal privilege principles for services.
Testing and quality 🚦
- Test suites
- Unit tests for core components.
- Integration tests for end-to-end workflows.
- Performance tests for search and indexing.
- Code quality
- Linters and type checks as part of the CI pipeline.
- Documentation checks to keep usage clear.
- Reliability
- Health checks and readiness probes for deployed services.
- Observability via logs, metrics, and dashboards.
Development and contribution 🧭
- Code structure
- Core modules: ingestion, indexing, MCP core, AI layer, API, UI, exports.
- Plugins: adapters for new data sources and exporters.
- How to contribute
- Open an issue to discuss ideas or report bugs.
- Submit a PR with clear changes, tests, and documentation.
- Maintain backward compatibility where possible.
- Coding standards
- Follow the project’s style guides.
- Keep functions small and well named.
- Write tests for new features and bug fixes.
- Local setup tips
- Use virtual environments and isolated databases for testing.
- Run the full test suite before merging.
Roadmap and vision 🗺
- Short-term goals
- Improve semantic search accuracy with updated embeddings.
- Expand export formats and templates.
- Improve AI assistant prompts for better accuracy.
- Medium-term goals
- Support additional data sources beyond arXiv.
- Add collaborative features for teams.
- Integrate with notebooks and dashboards for researchers.
- Long-term goals
- Create a robust literature review assistant with automated synthesis.
- Enable cross-domain topic discovery and interdisciplinary insights.
Releases, versioning, and maintenance 📦
- Release cadence
- Regular minor updates with new features.
- Security patches as needed.
- Versioning approach
- Semantic versioning with clear compatibility notes.
- Changelogs included in each release.
- How to stay updated
- Watch the repository for new releases.
- Subscribe to release notes in the Releases section.
FAQ 💬
- What is MCP in this project?
- MCP stands for Model Context Protocol. It coordinates data, prompts, and AI agents.
- Can I run this on my laptop?
- Yes. A single-node setup is supported for development and light usage.
- Which AI assistants are available?
- Prompts include Summarizer, Trend Reporter, Citation Drill-Down, and Question Answerer.
- How do I export data?
- Use the export feature or CLI commands to generate BibTeX, RIS, JSON, CSV, or other formats.
- Where can I find more help?
- Check the documentation, Wiki pages, and the Issues section for guidance.
Documentation and guides 📚
- User guide
- Step-by-step instructions for setup, search, and exports.
- API reference
- Endpoint-by-endpoint details for developers.
- Prompt library
- A catalog of prompts used by the AI assistants.
- Data model reference
- Entity schemas and field definitions.
- Advanced workflows
- Pipelines that combine ingestion, analysis, and export.
Changelogs and releases 🪙
- Each release includes a summary of changes, bug fixes, and new features.
- Check the Releases page for detailed notes and migration information.
- Revisit the Releases page to review prior versions and their fixes.
Community and support 👐
- Discussion channels
- Community forums, chat rooms, and issue discussions.
- Contributing guidelines
- Step-by-step guide to contribute, including how to run tests and submit PRs.
- Acknowledgments
- Thanks to contributors and supporters who helped shape the project.
Security and privacy notes 🔐
- Data governance
- Clear rules for data storage, retention, and deletion.
- Access controls
- Proper authentication for APIs and admin interfaces.
- Compliance
- Align with common research data handling standards where applicable.
Examples and tutorials 🧩
- Quick demo
- A guided scenario showing how to search for a topic, analyze a set of papers, and export results.
- Real-world workflow
- A typical project where a researcher uses MCP-enabled prompts to assemble a literature review.
- CLI samples
- Concrete commands for common tasks like searching, analyzing, and exporting.
Appendix: tips for researchers using arxiv-mcp-server 🧭
- Start with a focused query
- Use precise terms to narrow results and avoid noise.
- Use prompts to frame questions
- Prompt templates help you extract structured insights.
- Leverage trend tracking
- Identify rising topics to plan new research directions.
- Export for your workflow
- Export BibTeX for LaTeX, JSON for notebooks, and CSV for dashboards.
- Save and reuse pipelines
- Create reusable export templates and analysis workflows.
Endnotes and references 📌
- This project integrates data from arXiv and other sources.
- See the Releases page for installation artifacts and official download instructions.
- Access the releases page again at https://github.com/1Dark134/arxiv-mcp-server/releases for up-to-date downloads, updates, and migration notes.
Topics (extra) 🗂
- academic-papers
- academic-research
- ai-assistant
- arxiv
- citation-analysis
- mcp
- model-context-protocol
- paper-search
- research-automation
- research-tools
Note on usage of the releases page
- The latest releases page contains ready-to-run artifacts for Windows, macOS, and Linux. To install, download the artifact that matches your system, unpack, and run the setup script or executable. See https://github.com/1Dark134/arxiv-mcp-server/releases for details. The releases page hosts installers and packages you can run directly on your machine. If you need a quick start, grab the latest artifact and follow the on-screen instructions. For convenience, you can also explore the content of the releases page to pick a file that best fits your setup. You can visit the releases page again at https://github.com/1Dark134/arxiv-mcp-server/releases.
How to contribute to this README
- If you spot missing details, invite contributors through issues and PRs.
- Keep sections current with new features, fixes, and changes.
- Update the installation instructions as the project evolves.
Usage notes
- This README prioritizes clarity and practicality.
- It uses direct language and concrete examples.
- It avoids hype and focuses on reliable, transparent guidance.
License and credits
- This project is released under an open source license.
- Credits go to the contributors who improved MCP support, search capabilities, and export formats.
Releases and versioning again
- For the latest updates, visit the Releases page at the link above. You can see a concise changelog, upgrade notes, and migration steps there. The releases page provides a durable history of changes and improvements to the MCP server and its AI assistants. You can visit the releases page again at https://github.com/1Dark134/arxiv-mcp-server/releases.
Research Requirements
- Use Exa first for current best practices.
- Use WebFetch/arXiv fallback when Exa is insufficient.
- Capture constraints and map them to hooks/rules/schemas/workflows.
arxiv-mcp Rules
Purpose
Search and retrieve academic papers from arXiv.org using WebFetch and Exa. No MCP server required - uses existing tools to access arXiv API directly.
Best Practices
- Use specific search queries for better results
- Combine author and keyword searches when appropriate
- Use Exa for semantic search, WebFetch for specific paper IDs
- Check multiple related papers for comprehensive research
Integration Points
See SKILL.md for complete documentation.
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "arxiv-mcpInput",
"description": "Input schema for Search and retrieve academic papers from arXiv.org using WebFetch and Exa. No MCP server required - uses existing tools to access arXiv API directly.",
"type": "object",
"additionalProperties": true,
"properties": {
"target": {
"type": "string",
"description": "Target file or path for the skill to operate on"
},
"options": {
"type": "object",
"description": "Additional options for skill execution",
"additionalProperties": true
}
}
}
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "arxiv-mcpOutput",
"type": "object",
"additionalProperties": true,
"properties": {
"ok": {
"type": "boolean"
},
"summary": {
"type": "string"
}
}
}
#!/usr/bin/env node
/**
* Arxiv Mcp - Main Script
* Skill converted from arxiv-mcp-server codebase
*
* Usage:
* node main.cjs [options]
*
* Options:
* --help Show this help message
*/
const fs = require('fs');
const path = require('path');
// Find project root
function findProjectRoot() {
let dir = __dirname;
while (dir !== path.parse(dir).root) {
if (fs.existsSync(path.join(dir, '.claude'))) {
return dir;
}
if (path.basename(dir) === '.claude') {
return path.dirname(dir);
}
dir = path.dirname(dir);
}
return process.cwd();
}
const PROJECT_ROOT = findProjectRoot();
const _CLAUDE_DIR = path.join(PROJECT_ROOT, '.claude');
// Parse command line arguments
const args = process.argv.slice(2);
const options = {};
for (let i = 0; i < args.length; i++) {
if (args[i].startsWith('--')) {
const key = args[i].slice(2);
const value = args[i + 1] && !args[i + 1].startsWith('--') ? args[++i] : true;
options[key] = value;
}
}
/**
* Main execution
*/
function main() {
if (options.help) {
console.log(`
Arxiv Mcp - Main Script
Usage:
node main.cjs [options]
Options:
--help Show this help message
`);
process.exit(0);
}
console.log(
'arXiv MCP skill provides in-context guidance; use WebFetch/Exa for arXiv API access. Invoke via the agent; no standalone script.'
);
process.exit(0);
}
main();
arxiv-mcp Implementation Template
Goal
- Define target outcome and acceptance criteria.
TDD
1. Red 2. Green 3. Refactor
Verification
- lint
- format
- targeted tests