# `arxiv__arxiv_get_metadata` **Arxiv Get Metadata** Get full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory. - Server: [arXiv](https://gateway.mcpharbor.dev/docs/servers/arxiv) (`dev.mcpharbor.gateway/arxiv`) - Price per call: $0.0001 (100 micro-USD); only tools/call is charged - Endpoint: `https://gateway.mcpharbor.dev/mcp` or `https://gateway.mcpharbor.dev/mcp/arxiv` - Upstream tool: exposed by the provider; called through this gateway as `arxiv__arxiv_get_metadata` - Provider terms: (verified 2026-09-19) - Upstream API documentation: - Rate limit: 20 requests per minute - Attribution required: Thank you to arXiv for use of its open access interoperability. (requested, not required) ## Parameters - `paper_ids` (any, required): arXiv paper ID or array of up to 10 IDs. Format: "2401.12345" or "2401.12345v2" (with version). Also accepts legacy IDs like "hep-th/9901001". ## Example call Request headers and body: ```http POST /mcp HTTP/1.1 Host: gateway.mcpharbor.dev Authorization: Bearer Content-Type: application/json Accept: application/json, text/event-stream MCP-Protocol-Version: 2026-07-28 Mcp-Method: tools/call Mcp-Name: arxiv__arxiv_get_metadata ``` ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "_meta": { "io.modelcontextprotocol/clientCapabilities": {}, "io.modelcontextprotocol/clientInfo": { "name": "example-agent", "version": "1.0.0" }, "io.modelcontextprotocol/protocolVersion": "2026-07-28" }, "arguments": { "paper_ids": "example" }, "name": "arxiv__arxiv_get_metadata" } } ``` A successful response: ```json { "id": 1, "jsonrpc": "2.0", "result": { "_meta": { "dev.mcpharbor.gateway/call": { "chargedMicroUsd": 100, "id": "" } }, "content": [ { "text": "", "type": "text" } ], "resultType": "complete" } } ``` This call costs $0.0001 (100 micro-USD). Reading this page and listing the tool cost nothing. The `dev.mcpharbor.gateway/call` record in the result is the receipt for that charge. Each POST is metered separately, so sending the same call again buys another one: see [agent.txt](https://gateway.mcpharbor.dev/agent.txt), section 7, before retrying. ## Attribution This provider requires the attribution below wherever you use results from its tools. Reproduce it verbatim: > Thank you to arXiv for use of its open access interoperability. (requested, not required) ## Tool definition Exactly as `tools/list` returns it (free): ```json { "_meta": { "dev.mcpharbor.gateway/pricing": { "currency": "USD", "pricePerCallMicroUsd": 100 } }, "annotations": { "readOnlyHint": true }, "description": "Get full metadata for one or more arXiv papers by ID. Use when you have known IDs from citations, prior search results, or memory.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "paper_ids": { "anyOf": [ { "description": "Single arXiv paper ID (e.g., \"2401.12345\" or \"2401.12345v2\").", "minLength": 1, "type": "string" }, { "description": "Array of up to 10 arXiv paper IDs for batch lookup.", "items": { "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" } ], "description": "arXiv paper ID or array of up to 10 IDs. Format: \"2401.12345\" or \"2401.12345v2\" (with version). Also accepts legacy IDs like \"hep-th/9901001\"." } }, "required": [ "paper_ids" ], "type": "object" }, "name": "arxiv__arxiv_get_metadata", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "papers", "totalSucceeded" ] }, { "required": [ "error" ] } ], "properties": { "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode. Declared by this tool: `no_match`: None of the requested IDs returned data from arXiv. `version_unavailable`: Every requested ID pinned a version the local mirror does not hold, and live arXiv fallback is disabled. `rate_limited`: arXiv has throttled requests (HTTP 429 or \"Rate exceeded.\" body). `invalid_request`: arXiv rejected the request (HTTP 4xx other than 429), e.g. malformed ID syntax. Other values are possible when a failure originates below the handler.", "examples": [ "no_match", "version_unavailable", "rate_limited", "invalid_request" ], "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "not_found": { "description": "Per-input explanations for inputs that could not be returned. Absent when nothing failed.", "items": { "additionalProperties": false, "description": "A requested ID that could not be returned, with the reason it was missed.", "properties": { "detail": { "description": "Additional human-readable context, when available", "type": "string" }, "id": { "description": "arXiv ID that returned no data.", "type": "string" }, "reason": { "description": "Why the paper ID could not be returned.", "enum": [ "not_in_arxiv", "version_not_in_mirror" ], "type": "string" } }, "required": [ "id", "reason" ], "type": "object" }, "type": "array" }, "papers": { "description": "Papers found. May be fewer than requested if some IDs are invalid.", "items": { "additionalProperties": false, "description": "arXiv paper metadata — identifier, title, authors, abstract, categories, and links.", "properties": { "abstract": { "description": "Full abstract text.", "type": "string" }, "abstract_url": { "description": "arXiv abstract page URL.", "type": "string" }, "authors": { "description": "Author names.", "items": { "type": "string" }, "type": "array" }, "categories": { "description": "All arXiv categories assigned to this paper.", "items": { "type": "string" }, "type": "array" }, "comment": { "description": "Author comment (e.g., page count, conference).", "type": "string" }, "doi": { "description": "DOI if available.", "type": "string" }, "id": { "description": "arXiv paper ID (e.g., \"2401.12345v1\").", "type": "string" }, "journal_ref": { "description": "Journal reference if published.", "type": "string" }, "pdf_url": { "description": "Direct PDF download URL.", "type": "string" }, "primary_category": { "description": "Primary arXiv category (e.g., \"cs.CL\").", "type": "string" }, "published": { "description": "Original submission date (ISO 8601).", "type": "string" }, "title": { "description": "Paper title.", "type": "string" }, "updated": { "description": "Last update date (ISO 8601).", "type": "string" } }, "required": [ "id", "title", "authors", "abstract", "primary_category", "categories", "published", "updated", "pdf_url", "abstract_url" ], "type": "object" }, "type": "array" }, "totalSucceeded": { "description": "Number of successful items in 'papers'", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "type": "object" }, "title": "Arxiv Get Metadata" } ```