OpenCitations

liveResearchScience

OpenCitations COCI — open-license citation index. Keyless.

6tools
0msauth
free tier50 calls/day

Tools

referencesrequired: doi

"What does paper [DOI] cite" / "references in [paper]" / "what sources does this paper use" — DOIs cited BY the given DOI (the paper's reference list / bibliography). Use for citation-graph traversal,

Parameters
NameTypeDescription
doireqstring—
▶Try it
citationsrequired: doi

"Who cites paper [DOI]" / "what papers reference [DOI]" / "incoming citations to [paper]" / "what work has cited [study]" — DOIs that CITE the given DOI (reverse-direction from references). Use for im

Parameters
NameTypeDescription
doireqstring—
▶Try it
citation_countrequired: doi

"How many times has paper [DOI] been cited" / "citation count for [paper]" / "is [study] highly cited" — incoming citation count for a DOI. Fast version of `citations` when you only need the number, n

Parameters
NameTypeDescription
doireqstring—
▶Try it
references_countrequired: doi

"How many references does paper [DOI] have" / "how big is the bibliography of [paper]" — outgoing reference count for a DOI. Fast version of `references` when you only need the number.

Parameters
NameTypeDescription
doireqstring—
▶Try it
metadatarequired: dois

"Get paper info for [DOI]" / "bibliographic details for [paper]" / "title / authors / year of [DOI]" — bibliographic metadata for one or more DOIs (up to 50 at once). Returns title, authors, year, jou

Parameters
NameTypeDescription
doisreqarray—
▶Try it
citationrequired: oci

Fetch one citation record by its Open Citation Identifier (OCI — a compound ID of the form citing-DOI__cited-DOI). Returns citing/cited DOI pair, creation date, and journal self-citation flag. Use `ci

Parameters
NameTypeDescription
ocireqstring—
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/opencitations/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/opencitations/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"references","arguments":{"doi": "10.1038/nature12373"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("references", {"doi":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("opencitations coci — open-license citation index");