`search_publications`

Pack: nih-reporter · Endpoint: https://gateway.pipeworx.io/nih-reporter/mcp

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, or use one-click install buttons:

{
  "mcpServers": {
    "nih-reporter": {
      "url": "https://gateway.pipeworx.io/nih-reporter/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_publications