ArXiv MCP Server

Instructions

Implementation Reference

• src/arxiv_mcp_server/tools/read_paper.py:32-79 (handler)

  The async handler function that executes the read_paper tool: validates paper_id, checks existence via list_papers, reads markdown from storage, returns JSON-wrapped content or error.

  async def handle_read_paper(arguments: Dict[str, Any]) -> List[types.TextContent]:
      """Handle requests to read a paper's content."""
      try:
          paper_ids = list_papers()
          paper_id = arguments["paper_id"]
          # Check if paper exists
          if paper_id not in paper_ids:
              return [
                  types.TextContent(
                      type="text",
                      text=json.dumps(
                          {
                              "status": "error",
                              "message": f"Paper {paper_id} not found in storage. You may need to download it first using download_paper.",
                          }
                      ),
                  )
              ]
  
          # Get paper content
          content = Path(settings.STORAGE_PATH, f"{paper_id}.md").read_text()
  
          return [
              types.TextContent(
                  type="text",
                  text=json.dumps(
                      {
                          "status": "success",
                          "paper_id": paper_id,
                          "content": content,
                      }
                  ),
              )
          ]
  
      except Exception as e:
          return [
              types.TextContent(
                  type="text",
                  text=json.dumps(
                      {
                          "status": "error",
                          "message": f"Error reading paper: {str(e)}",
                      }
                  ),
              )
          ]

• src/arxiv_mcp_server/tools/read_paper.py:11-24 (schema)

  Tool schema definition including name, description, and inputSchema requiring paper_id.

  read_tool = types.Tool(
      name="read_paper",
      description="Read the full content of a stored paper in markdown format",
      inputSchema={
          "type": "object",
          "properties": {
              "paper_id": {
                  "type": "string",
                  "description": "The arXiv ID of the paper to read",
              }
          },
          "required": ["paper_id"],
      },
  )

• src/arxiv_mcp_server/server.py:41-45 (registration)

  Registers the read_paper tool (imported as read_tool) by including it in the list returned by server.list_tools().

  @server.list_tools()
  async def list_tools() -> List[types.Tool]:
      """List available arXiv research tools."""
      return [search_tool, download_tool, list_tool, read_tool]

• src/arxiv_mcp_server/server.py:47-65 (registration)

  The server's call_tool method dispatches to handle_read_paper when name=='read_paper'.

  @server.call_tool()
  async def call_tool(name: str, arguments: Dict[str, Any]) -> List[types.TextContent]:
      """Handle tool calls for arXiv research functionality."""
      logger.debug(f"Calling tool {name} with arguments {arguments}")
      try:
          if name == "search_papers":
              return await handle_search(arguments)
          elif name == "download_paper":
              return await handle_download(arguments)
          elif name == "list_papers":
              return await handle_list_papers(arguments)
          elif name == "read_paper":
              return await handle_read_paper(arguments)
          else:
              return [types.TextContent(type="text", text=f"Error: Unknown tool {name}")]
      except Exception as e:
          logger.error(f"Tool error: {str(e)}")
          return [types.TextContent(type="text", text=f"Error: {str(e)}")]

• src/arxiv_mcp_server/tools/read_paper.py:27-29 (helper)

  Helper function to list all stored paper IDs, used by handle_read_paper to check existence.

  def list_papers() -> list[str]:
      """List all stored paper IDs."""
      return [p.stem for p in Path(settings.STORAGE_PATH).glob("*.md")]