Arxiv

You can run the ArxivSearch MCP Server to perform intelligent, filterable searches of arXiv software engineering papers, analyze trends, and export results. It supports remote cloud access, local development, and easy integration with MCP clients to power your workflows.

How to use

Connect to the MCP server using your MCP client or editor. You have three practical methods: 1) Consume the cloud-hosted HTTP endpoint, 2) Run a local STDIO server via Docker, 3) Run a local STDIO server with uv for development. Once connected, you can search papers, fetch paper details, filter by authors, analyze trends, find related works, download PDFs, and export results in multiple formats. Use the cloud URL for quick testing, or run locally to keep data on your machine and customize development.

How to install

Prerequisites: ensure you have Python 3.11 or higher and uv installed for local development. You can also run the server in Docker if you prefer containerized deployment. Optional: Node.js and npm if you plan to debug with MCP Inspector.

{
  "mcpServers": {
    "arxiv_mcp": {
      "type": "http",
      "url": "https://arxiv-mcp-sq0a.onrender.com/mcp/",
      "args": []
    },
    "arxiv_search": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "arxiv-searcher-mcp"
      ]
    },
    "arxiv_uv": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "${workspaceFolder}/arxiv_searcher/arxiv_mcp.py"
      ]
    }
  }
}

Additional sections

Configuration and usage notes to guide you through common tasks, security considerations, and troubleshooting tips. The cloud endpoint is suitable for quick tests, while local STDIO options are best for development, debugging, and custom deployments.

Available tools

search_papers

Searches arXiv papers filtered by the Software Engineering category (cs.SE) with parameters like query, max_results, start_date, end_date, sort_by_relevance, and category.

get_paper_details

Retrieves detailed information about a paper by its arXiv ID, including title, authors, abstract, dates, categories, DOI, and more.

search_by_author

Finds papers by author with optional category and date filters, returning a list of matching papers.

analyze_paper_trends

Analyzes trends across a collection of papers, including authors, keywords, timelines, and categories, yielding statistics and insights.

find_related_papers

Finds papers related to a reference by title using keyword similarity, with controls for maximum results and category.

download_paper_pdf

Downloads the PDF of an arXiv paper given a URL, saving to a specified path and filename.

export_search_results

Exports search results to formats like BibTeX, CSV, JSON, or Markdown, producing a file path and a content preview.

get_arxiv_categories

Returns the list of arXiv categories and their descriptions for easy filtering and discovery.