`get_project`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_project for the schema, then POST the same URL with its arguments for the data.

Fetch one NIH project application record by application ID (numeric, distinct from project number). Returns its complete abstract, public-health relevance, terms, PIs, organization, dates, and award amount. Use nih_grant_award_history for multi-year award history.

Parameters

Name	Type	Required	Description
`appl_id`	number	yes	NIH application ID (integer)

Example call

Arguments

{
  "appl_id": 10812345
}

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":"get_project","arguments":{"appl_id":10812345}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_project', {
  "appl_id": 10812345
});

Response shape

Always returns: appl_id, project_num, core_project_num, title, fiscal_year, award_amount, award_notice_date, project_start, project_end, nih_institute, nih_institute_name, contact_pi, pis, organization, org_city, org_state, org_country, terms_preview, reporter_url, abstract, public_health_relevance, terms

Field	Type	Description
`appl_id`	number \| null	NIH application ID
`project_num`	string \| null	Project number
`core_project_num`	string \| null	Core project number
`title`	string \| null	Project title
`fiscal_year`	number \| null	Fiscal year of award
`award_amount`	number \| null	Total award amount in dollars
`award_notice_date`	string \| null	Award notice date
`project_start`	string \| null	Project start date
`project_end`	string \| null	Project end date
`nih_institute`	string \| null	NIH Institute/Center abbreviation or code
`nih_institute_name`	string \| null	Full name of NIH Institute/Center
`contact_pi`	string \| null	Contact principal investigator name
`pis`	array	List of principal investigator names
`organization`	string \| null	Organization/institution name
`org_city`	string \| null	Organization city
`org_state`	string \| null	Organization state code
`org_country`	string \| null	Organization country
`terms_preview`	string \| null	Preferred terms/keywords preview
`reporter_url`	string \| null	Direct link to project on NIH Reporter
`abstract`	string \| null	Full project abstract text
`public_health_relevance`	string \| null	Public health relevance statement
`terms`	string \| null	Complete terms/keywords for project

Full JSON Schema

{
  "type": "object",
  "properties": {
    "appl_id": {
      "type": [
        "number",
        "null"
      ],
      "description": "NIH application ID"
    },
    "project_num": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project number"
    },
    "core_project_num": {
      "type": [
        "string",
        "null"
      ],
      "description": "Core project number"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project title"
    },
    "fiscal_year": {
      "type": [
        "number",
        "null"
      ],
      "description": "Fiscal year of award"
    },
    "award_amount": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total award amount in dollars"
    },
    "award_notice_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award notice date"
    },
    "project_start": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project start date"
    },
    "project_end": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project end date"
    },
    "nih_institute": {
      "type": [
        "string",
        "null"
      ],
      "description": "NIH Institute/Center abbreviation or code"
    },
    "nih_institute_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full name of NIH Institute/Center"
    },
    "contact_pi": {
      "type": [
        "string",
        "null"
      ],
      "description": "Contact principal investigator name"
    },
    "pis": {
      "type": "array",
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "List of principal investigator names"
    },
    "organization": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization/institution name"
    },
    "org_city": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization city"
    },
    "org_state": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization state code"
    },
    "org_country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization country"
    },
    "terms_preview": {
      "type": [
        "string",
        "null"
      ],
      "description": "Preferred terms/keywords preview"
    },
    "reporter_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Direct link to project on NIH Reporter"
    },
    "abstract": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full project abstract text"
    },
    "public_health_relevance": {
      "type": [
        "string",
        "null"
      ],
      "description": "Public health relevance statement"
    },
    "terms": {
      "type": [
        "string",
        "null"
      ],
      "description": "Complete terms/keywords for project"
    }
  },
  "required": [
    "appl_id",
    "project_num",
    "core_project_num",
    "title",
    "fiscal_year",
    "award_amount",
    "award_notice_date",
    "project_start",
    "project_end",
    "nih_institute",
    "nih_institute_name",
    "contact_pi",
    "pis",
    "organization",
    "org_city",
    "org_state",
    "org_country",
    "terms_preview",
    "reporter_url",
    "abstract",
    "public_health_relevance",
    "terms"
  ]
}

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.

get_project