list_downloaded_papers
View locally cached arXiv papers with metadata to quickly access previously downloaded scientific literature without re-searching.
Instructions
List all locally downloaded papers.
Returns:
List of downloaded papers with their metadataInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/arxiv_mcp_server/server.py:99-119 (handler)The handler function decorated with @mcp.tool(), implementing the logic to list downloaded papers by fetching from storage, formatting metadata, and returning a string list.
@mcp.tool() def list_downloaded_papers() -> str: """List all locally downloaded papers. Returns: List of downloaded papers with their metadata """ papers = storage.list_papers() if not papers: return "No papers downloaded yet." results = [] for p in papers: authors = ", ".join(p["authors"][:3]) if len(p["authors"]) > 3: authors += " et al." results.append(f"**{p['id']}**: {p['title']}\nAuthors: {authors}") return "\n---\n".join(results) - Supporting helper method in PaperStorage class that returns all stored paper metadata as a list of dictionaries, used by the tool handler.
def list_papers(self) -> list[dict]: return list(self._metadata.values()) - src/arxiv_mcp_server/server.py:99-99 (registration)The @mcp.tool() decorator registers the list_downloaded_papers function as an MCP tool.
@mcp.tool()