search_papers
Pack: arxiv · Endpoint: https://gateway.pipeworx.io/arxiv/mcp
Search arXiv preprints. Plain text searches all fields; use prefixes for targeted queries: au:hinton (author), ti:transformer (title), abs:diffusion (abstract), cat:cs.AI (category), all:quantum (any field). Combine with AND/OR/ANDNOT, e.g., “ti:transformer AND cat:cs.LG”. Returns id, title, authors, abstract, categories, published date, PDF URL.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Query string. Plain text or field-prefixed (au:, ti:, abs:, cat:, all:). Combine terms with AND, OR, ANDNOT. |
max_results | number | no | Maximum papers to return (1-100, default 10) |
sort_by | string | no | relevance | lastUpdatedDate | submittedDate (default relevance) |
sort_order | string | no | ascending | descending (default descending) |
Example call
curl -X POST https://gateway.pipeworx.io/arxiv/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_papers","arguments":{}}}'
Response shape
Always returns: total_results, results
| Field | Type | Description |
|---|---|---|
total_results | number | Total number of papers matching the query |
results | array | List of papers found |
Full JSON Schema
{
"type": "object",
"properties": {
"total_results": {
"type": "number",
"description": "Total number of papers matching the query"
},
"results": {
"type": "array",
"description": "List of papers found",
"items": {
"type": "object",
"properties": {
"arxiv_id": {
"type": "string",
"description": "arXiv identifier"
},
"title": {
"type": "string",
"description": "Paper title"
},
"summary": {
"type": "string",
"description": "Paper abstract/summary"
},
"authors": {
"type": "array",
"description": "List of author names",
"items": {
"type": "string"
}
},
"categories": {
"type": "array",
"description": "List of arXiv category tags",
"items": {
"type": "string"
}
},
"primary_category": {
"type": [
"string",
"null"
],
"description": "Primary arXiv category"
},
"published": {
"type": "string",
"description": "Publication date (ISO 8601)"
},
"updated": {
"type": "string",
"description": "Last update date (ISO 8601)"
},
"pdf_url": {
"type": [
"string",
"null"
],
"description": "URL to PDF version"
},
"abs_url": {
"type": [
"string",
"null"
],
"description": "URL to abstract page"
},
"doi": {
"type": [
"string",
"null"
],
"description": "Digital Object Identifier if available"
},
"journal_ref": {
"type": [
"string",
"null"
],
"description": "Journal reference if published"
},
"comment": {
"type": [
"string",
"null"
],
"description": "Author comment if present"
}
},
"required": [
"arxiv_id",
"title",
"summary",
"authors",
"categories",
"published",
"updated"
]
}
}
},
"required": [
"total_results",
"results"
]
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"arxiv": {
"url": "https://gateway.pipeworx.io/arxiv/mcp"
}
}
}
See Getting Started for client-specific install steps.