{"_id":"@ahmeshaf/mcp-server-opencitations","_rev":"3-f33688261f7eefd07612d421cc459158","name":"@ahmeshaf/mcp-server-opencitations","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.3":{"name":"@ahmeshaf/mcp-server-opencitations","version":"0.1.3","keywords":["mcp","model-context-protocol","opencitations","citations","api"],"author":{"name":"ahmeshaf"},"license":"MIT","_id":"@ahmeshaf/mcp-server-opencitations@0.1.3","maintainers":[{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"}],"homepage":"https://github.com/ahmeshaf/mcp-server-opencitations#readme","bugs":{"url":"https://github.com/ahmeshaf/mcp-server-opencitations/issues"},"bin":{"mcp-server-opencitations":"dist/index.js"},"dist":{"shasum":"7a93a6f2af0547aeab7f89c5554981c0c68bb7b9","tarball":"https://registry.npmjs.org/@ahmeshaf/mcp-server-opencitations/-/mcp-server-opencitations-0.1.3.tgz","fileCount":4,"integrity":"sha512-jhDsD2OqdizXkV/3e+seVB3imIs7wou4Xew2E7e/RperZWFcNv4RlLdLFwCqDV8PeDZOic3ncvz00RjOePb3KA==","signatures":[{"sig":"MEQCIBjjlfx247TCAXG5YTUoz7NKPWQBnxmFeDn9DdKTV6q2AiAqipAiID/6tO5v/NXu25KTLBXu7wc8bSCqrZWtI7P/Vg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13454},"type":"module","gitHead":"37b2926d2f8bad39f880a04047fb4f807c9c60e3","scripts":{"test":"vitest run","build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"},"repository":{"url":"git+https://github.com/ahmeshaf/mcp-server-opencitations.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for OpenCitations API","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.24.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","vitest":"^2.1.8","typescript":"^5.8.2","@types/node":"^22","@vitest/coverage-v8":"^2.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-opencitations_0.1.3_1767752062602_0.37007690214713973","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ahmeshaf/mcp-server-opencitations","version":"0.1.4","keywords":["mcp","model-context-protocol","opencitations","citations","api"],"author":{"name":"ahmeshaf"},"license":"MIT","_id":"@ahmeshaf/mcp-server-opencitations@0.1.4","maintainers":[{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"}],"homepage":"https://github.com/ahmeshaf/mcp-server-opencitations#readme","bugs":{"url":"https://github.com/ahmeshaf/mcp-server-opencitations/issues"},"bin":{"mcp-server-opencitations":"dist/index.js"},"dist":{"shasum":"d2265b94dc0abbefb205d494f6c186e025d87ea9","tarball":"https://registry.npmjs.org/@ahmeshaf/mcp-server-opencitations/-/mcp-server-opencitations-0.1.4.tgz","fileCount":5,"integrity":"sha512-s6dOy/4vLAWwii6hXySWLVIvJ2X4eRhaJRmIhGV/sgz6ZbZNwFKPNthqPDvoGGNHVcVpGRduAlRBINQfQ419xw==","signatures":[{"sig":"MEQCICz3ROB065N/K5Ou69w6X8Od/kyaAG9WsYTs+K+J9v68AiBto2NGmU8z0O1yQf2EuXVILLqR6t5znMv3Iab3A/D6Jw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17272},"type":"module","gitHead":"37b2926d2f8bad39f880a04047fb4f807c9c60e3","scripts":{"test":"vitest run","build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"},"repository":{"url":"git+https://github.com/ahmeshaf/mcp-server-opencitations.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for OpenCitations API","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.24.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","vitest":"^2.1.8","typescript":"^5.8.2","@types/node":"^22","@vitest/coverage-v8":"^2.1.8"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-opencitations_0.1.4_1767752272619_0.5316423378880151","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@ahmeshaf/mcp-server-opencitations","version":"0.1.5","description":"MCP server for OpenCitations API","license":"MIT","author":{"name":"ahmeshaf"},"keywords":["mcp","model-context-protocol","opencitations","citations","api"],"homepage":"https://github.com/ahmeshaf/servers/tree/main/src/opencitations","repository":{"type":"git","url":"git+https://github.com/ahmeshaf/servers.git","directory":"src/opencitations"},"type":"module","bin":{"mcp-server-opencitations":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage"},"dependencies":{"@modelcontextprotocol/sdk":"^1.24.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22","@vitest/coverage-v8":"^2.1.8","shx":"^0.3.4","typescript":"^5.8.2","vitest":"^2.1.8"},"_id":"@ahmeshaf/mcp-server-opencitations@0.1.5","gitHead":"37b2926d2f8bad39f880a04047fb4f807c9c60e3","bugs":{"url":"https://github.com/ahmeshaf/servers/issues"},"_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-rlK+W+XuaQDv4jbBv9/o1l/beaZt2yok1Lv9xxziRNy/xWNKAXL6sviAOcUZ11upe2YvNQ96YzFPgM173IfVyg==","shasum":"dec26b69b4ee548828a375e26b87d6b8c02fa288","tarball":"https://registry.npmjs.org/@ahmeshaf/mcp-server-opencitations/-/mcp-server-opencitations-0.1.5.tgz","fileCount":5,"unpackedSize":17516,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDmMHIuxm0+AmzIEJmN0RPH/DXOUJkBteGAOzmGB00WYQIhAPYis4Mc+FxUlzuZqduwwljd7lJnP5oHyVPDMUOi4vcv"}]},"_npmUser":{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"},"directories":{},"maintainers":[{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-opencitations_0.1.5_1767752568739_0.37998493381014153"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-07T02:14:22.518Z","modified":"2026-01-07T02:22:49.136Z","0.1.3":"2026-01-07T02:14:22.759Z","0.1.4":"2026-01-07T02:17:52.809Z","0.1.5":"2026-01-07T02:22:48.908Z"},"bugs":{"url":"https://github.com/ahmeshaf/servers/issues"},"author":{"name":"ahmeshaf"},"license":"MIT","homepage":"https://github.com/ahmeshaf/servers/tree/main/src/opencitations","keywords":["mcp","model-context-protocol","opencitations","citations","api"],"repository":{"type":"git","url":"git+https://github.com/ahmeshaf/servers.git","directory":"src/opencitations"},"description":"MCP server for OpenCitations API","maintainers":[{"name":"ahmeshaf","email":"ahmeshaf.rehan@gmail.com"}],"readme":"# OpenCitations MCP Server\n\nAn MCP (Model Context Protocol) server that provides access to the [OpenCitations](https://opencitations.net/) API. This allows LLMs to query citation data, find papers that cite a given work, and explore reference networks.\n\n## Installation\n\n```bash\nnpx @ahmeshaf/mcp-server-opencitations\n```\n\nOr install globally:\n\n```bash\nnpm install -g @ahmeshaf/mcp-server-opencitations\n```\n\n## Configuration\n\n### Access Token (Optional)\n\nOpenCitations API works without authentication, but providing a token is encouraged:\n\n```bash\n# Via command line argument\nnpx @ahmeshaf/mcp-server-opencitations --token=YOUR_TOKEN\n\n# Via environment variable\nexport OPENCITATIONS_ACCESS_TOKEN=YOUR_TOKEN\nnpx @ahmeshaf/mcp-server-opencitations\n```\n\n### Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"opencitations\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ahmeshaf/mcp-server-opencitations\"],\n      \"env\": {\n        \"OPENCITATIONS_ACCESS_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### citation_count\n\nGet the number of papers that cite a given DOI.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `doi` | string | Yes | DOI of the paper (e.g., `10.1108/jd-12-2013-0166`) |\n\n**Example:**\n```\ncitation_count(\"10.1108/jd-12-2013-0166\")\n→ Citation count for 10.1108/jd-12-2013-0166: 38\n```\n\n### get_citations\n\nGet all papers that cite a given DOI.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `doi` | string | Yes | DOI of the paper |\n\n**Returns:** List of citing papers with OCI, citing DOI, cited DOI, date, and self-citation flags.\n\n### reference_count\n\nGet the number of references in a paper (papers it cites).\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `doi` | string | Yes | DOI of the paper (e.g., `10.7717/peerj-cs.421`) |\n\n**Example:**\n```\nreference_count(\"10.7717/peerj-cs.421\")\n→ Reference count for 10.7717/peerj-cs.421: 42\n```\n\n### get_references\n\nGet all papers referenced by a given DOI.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `doi` | string | Yes | DOI of the paper |\n\n**Returns:** List of referenced papers with OCI, citing DOI, cited DOI, date, and self-citation flags.\n\n### get_citation\n\nGet metadata for a specific citation link using its Open Citation Identifier (OCI).\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `oci` | string | Yes | Open Citation Identifier (e.g., `06101801781-06180334099`) |\n\n**Returns:** Citation metadata including citing paper, cited paper, date, timespan, and self-citation flags.\n\n### venue_citation_count\n\nGet the total number of citations for all papers published in a journal.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `issn` | string | Yes | ISSN of the journal (e.g., `0138-9130`) |\n\n**Example:**\n```\nvenue_citation_count(\"0138-9130\")\n→ Total citations for venue 0138-9130: 125000\n```\n\n## Supported Identifier Formats\n\n| Type | Format | Example |\n|------|--------|---------|\n| DOI | `10.xxx/xxx` or `doi:10.xxx/xxx` | `10.1108/jd-12-2013-0166` |\n| ISSN | `xxxx-xxxx` or `issn:xxxx-xxxx` | `0138-9130` |\n| OCI | `xxx-xxx` | `06101801781-06180334099` |\n\nDOI URLs are also accepted: `https://doi.org/10.1108/jd-12-2013-0166`\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally\nnode dist/index.js\n\n# Test with MCP inspector\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## API Reference\n\nThis server uses the [OpenCitations Index API v2](https://api.opencitations.net/index/v2).\n\n## Repository\n\nSource code: [github.com/ahmeshaf/servers/src/opencitations](https://github.com/ahmeshaf/servers/tree/main/src/opencitations)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}