# ArXiv Scout

Search and retrieve academic papers directly from arXiv with advanced query capabilities. Extract full text from PDFs to generate summaries, literature reviews, and side-by-side comparisons. Track ci…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add shawnnygoh/arxiv-scout

# Browse available tools
npx -y @smithery/cli@latest tool list shawnnygoh/arxiv-scout

# Get full schema for a tool
npx -y @smithery/cli@latest tool get shawnnygoh/arxiv-scout arxiv_search_papers

# Call a tool
npx -y @smithery/cli@latest tool call shawnnygoh/arxiv-scout arxiv_search_papers '{}'
```

## Direct MCP Connection

Endpoint: `https://arxiv-scout--shawnnygoh.run.tools`

**Optional config:**
- `SEMANTIC_SCHOLAR_API_KEY` (query) — Optional API key for Semantic Scholar to enable higher rate limits.

## Tools (8)

- `arxiv_search_papers` — Search arXiv for papers using advanced query syntax.
- `arxiv_get_paper` — Fetch complete metadata for a specific arXiv paper.
- `arxiv_get_papers_batch` — Retrieve metadata for multiple papers in a single call.
- `arxiv_download_and_extract` — Extract full text from a paper's PDF.
- `arxiv_get_references` — List the papers that this paper cites.
- `arxiv_get_citations` — List newer papers that have cited this paper.
- `arxiv_list_categories` — Browse the arXiv category taxonomy.
- `arxiv_cache_stats` — View internal cache hit rates and sizes.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get shawnnygoh/arxiv-scout <tool-name>
```

## Resources

- `arxiv://categories` — A full list of arXiv subject category codes and their descriptions.
- `arxiv://help/query-syntax` — A reference guide for advanced search operators like ti:, au:, and boolean logic.
- `arxiv://server/info` — An overview of the server's version, tools, and citations data source.

## Prompts (3)

- `summarize_paper` (arxiv_id) — Generate a high-quality structured summary using extracted full text.
- `compare_papers` (arxiv_ids) — Perform a side-by-side analysis of 2-5 arXiv papers.
- `literature_review` (topic, max_papers, categories) — Synthesize a professional literature review for a research topic.