read_paper
Access and read full research paper content in markdown format using arXiv ID to retrieve stored academic papers.
Instructions
Read the full content of a stored paper in markdown format
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paper_id | Yes | The arXiv ID of the paper to read |
Implementation Reference
- 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)}", } ), ) ]
- 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)}")]
- 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")]