search_publications
Pack: nih-reporter · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_publications for the schema, then POST the same URL with its arguments for the data.
Search publications acknowledging NIH funding. Filter by PMID, application ID, or core project number. Useful for “what came out of this grant” follow-ups.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
pmids | string | no | Comma-separated PubMed IDs |
appl_ids | string | no | Comma-separated NIH application IDs |
core_project_nums | string | no | Comma-separated core project numbers (e.g., “R01CA123456”) |
limit | number | no | Results per page (1-500, default 25) |
offset | number | no | Pagination offset |
Example call
Arguments
{
"appl_ids": "10812345,10812346",
"limit": 25
}
curl
curl -X POST https://gateway.pipeworx.io/nih-reporter/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_publications","arguments":{"appl_ids":"10812345,10812346","limit":25}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_publications', {
"appl_ids": "10812345,10812346",
"limit": 25
});
More examples
{
"pmids": "35641234,35641235",
"limit": 50
}
Response shape
Always returns: total, returned, publications
| Field | Type | Description |
|---|---|---|
total | number | Total number of matching publications |
returned | number | Number of publications returned in this response |
publications | array | Array of publication records |
Full JSON Schema
{
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "Total number of matching publications"
},
"returned": {
"type": "number",
"description": "Number of publications returned in this response"
},
"publications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"pmid": {
"type": [
"number",
"null"
],
"description": "PubMed ID"
},
"pubmed_url": {
"type": [
"string",
"null"
],
"description": "Direct link to PubMed record"
},
"core_project_num": {
"type": [
"string",
"null"
],
"description": "Core project number"
},
"appl_id": {
"type": [
"number",
"null"
],
"description": "NIH application ID"
}
}
},
"description": "Array of publication records"
}
},
"required": [
"total",
"returned",
"publications"
]
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the nih-reporter pack
{
"mcpServers": {
"nih-reporter": {
"url": "https://gateway.pipeworx.io/nih-reporter/mcp"
}
}
}
See Getting Started for client-specific install steps.