{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8jakyeavqpq2","handle":"crossref-cite-mcp","url":"https://wellknown.network/agents/crossref-cite-mcp","links":{"self":"https://wellknown.network/agents/crossref-cite-mcp/record.json","html":"https://wellknown.network/agents/crossref-cite-mcp","markdown":"https://wellknown.network/agents/crossref-cite-mcp/record.md","api":"https://wellknown.network/api/v1/agents/crossref-cite-mcp","status":"https://wellknown.network/api/v1/agents/crossref-cite-mcp/status","claim":"https://wellknown.network/agents/crossref-cite-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/crossref-cite-mcp/claim.json","badge":"https://wellknown.network/agents/crossref-cite-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/crossref-cite-mcp/history","tools":"https://wellknown.network/api/v1/agents/crossref-cite-mcp/tools"},"ard":{"identifier":"urn:air::server:crossref-cite-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"crossref-cite-mcp","summary":"MCP tool for resolving paper citations via Crossref API with multiple format support","description":"# crossref-cite-mcp\n\nA Model Context Protocol (MCP) server for resolving paper citations via Crossref API. Supports multiple output formats including CSL-JSON, BibTeX, RIS, and formatted text.\n\n## Features\n\n- 🔍 **Smart Input Parsing**: Automatically detects DOIs, arXiv IDs, PMIDs, or falls back to bibliographic search\n- 📚 **Multiple Citation Formats**: CSL-JSON, BibTeX, RIS, and formatted text (APA, Chicago, IEEE, etc.)\n- ⚡ **Built-in Caching**: Memory or JSON file cache with configurable TTL (default: 14 days)\n- 🔄 **Retry Logic**: Exponential backoff for rate limits (429) and server errors (5xx)\n- 🎯 **Polite Pool Support**: Uses `mailto` parameter for higher Crossref rate limits\n\n## Installation\n\n### From PyPI (recommended)\n\n```bash\n# Using uv (recommended)\nuv pip install crossref-cite-mcp\n\n# Or using pip\npip install crossref-cite-mcp\n```\n\n### From Source (for development)\n\n```bash\n# Clone the repository\ngit clone https://github.com/h-lu/crossref-cite-mcp.git\ncd crossref-cite-mcp\n\n# Install with uv\nuv pip install -e .\n\n# Or use pip\npip install -e .\n```\n\n## Configuration\n\nSet environment variables (or create a `.env` file):\n\n```bash\n# Required: Your email for Crossref polite pool\nexport CROSSREF_MAILTO=your-email@example.com\n\n# Optional: Cache configuration\nexport CROSSREF_CACHE_BACKEND=json        # \"memory\" or \"json\"\nexport CROSSREF_CACHE_PATH=~/.crossref-cite/cache.json\nexport CROSSREF_CACHE_TTL=1209600         # 14 days in seconds\n\n# Optional: Logging\nexport LOG_LEVEL=INFO\n```\n\n## Configure Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n### Using uvx (recommended, no pre-installation required)\n\n```json\n{\n  \"mcpServers\": {\n    \"crossref-cite\": {\n      \"command\": \"uvx\",\n      \"args\": [\"crossref-cite-mcp\"],\n      \"env\": {\n        \"CROSSREF_MAILTO\": \"your-email@example.com\"\n      }\n    }\n  }\n}\n```\n\n### Using pip installed package\n\n```json\n{\n  \"mcpServers\": {\n    \"crossref-cite\": {\n      \"command\": \"crossref-cite…","publisher":null,"homepage":"https://github.com/h-lu/crossref-cite-mcp","repository":"https://github.com/h-lu/crossref-cite-mcp","version":"0.1.2","license":null,"protocols":["mcp"],"tags":["bibliography","bibtex","citation","crossref","doi","mcp"],"pricing":null,"endpoints":[{"url":"pypi:crossref-cite-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"research.academic","name":"Academic Research","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","research"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"crossref-cite-mcp","registry":"pypi","observedAt":"2026-11-03T00:27:59.916Z","publishedAt":"2025-12-20T01:36:27.984124Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"crossref-cite-mcp","url":"https://pypi.org/project/crossref-cite-mcp/","firstSeenAt":"2026-09-09T13:20:48.463Z","fetchedAt":"2026-11-03T00:26:25.537Z","normalizedAt":"2026-11-03T00:26:25.537Z"}]},"firstSeenAt":"2026-09-09T13:20:48.463Z","updatedAt":"2026-11-03T00:27:59.916Z"}