`get_award`

Pack: nsf-awards · Endpoint: https://gateway.pipeworx.io/nsf-awards/mcp

Fetch a single NSF award by ID. Returns full abstract, project outcomes report (if completed), and detailed PI/awardee info.

Parameters

Name	Type	Required	Description
`award_id`	string	yes	NSF award ID (numeric string)

Example call

Arguments

{
  "award_id": "2147483647"
}

curl

curl -X POST https://gateway.pipeworx.io/nsf-awards/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_award","arguments":{"award_id":"2147483647"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_award', {
  "award_id": "2147483647"
});

Response shape

Always returns: award_id, title, pi, awardee, awardee_city, awardee_state, awardee_country, funds_obligated, estimated_total, start_date, expiration_date, award_date, agency, program, cfda_number, transaction_type, nsf_url, pi_email, co_pi, performance_location, performance_city, performance_state, performance_zip, awardee_address, abstract, outcomes_report, publications

Field	Type	Description
`award_id`	string \| null	NSF award ID
`title`	string \| null	Award title
`pi`	string \| null	Principal Investigator name
`awardee`	string \| null	Awardee institution name
`awardee_city`	string \| null	Awardee city
`awardee_state`	string \| null	Awardee US state code
`awardee_country`	string \| null	Awardee country code
`funds_obligated`	number \| null	Funds obligated amount
`estimated_total`	number \| null	Estimated total award amount
`start_date`	string \| null	Award start date
`expiration_date`	string \| null	Award expiration date
`award_date`	string \| null	Award date
`agency`	string \| null	Funding agency
`program`	string \| null	NSF program name
`cfda_number`	string \| null	CFDA program number
`transaction_type`	string \| null	Transaction type
`nsf_url`	string \| null	URL to NSF award search page
`pi_email`	string \| null	PI email address
`co_pi`	array	Co-PI names
`performance_location`	string \| null	Performance location
`performance_city`	string \| null	Performance city
`performance_state`	string \| null	Performance state code
`performance_zip`	string \| null	Performance ZIP code
`awardee_address`	string \| null	Awardee full address
`abstract`	string \| null	Award abstract
`outcomes_report`	string \| null	Project outcomes report
`publications`	array	Research and conference publications

Full JSON Schema

{
  "type": "object",
  "properties": {
    "award_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "NSF award ID"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award title"
    },
    "pi": {
      "type": [
        "string",
        "null"
      ],
      "description": "Principal Investigator name"
    },
    "awardee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Awardee institution name"
    },
    "awardee_city": {
      "type": [
        "string",
        "null"
      ],
      "description": "Awardee city"
    },
    "awardee_state": {
      "type": [
        "string",
        "null"
      ],
      "description": "Awardee US state code"
    },
    "awardee_country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Awardee country code"
    },
    "funds_obligated": {
      "type": [
        "number",
        "null"
      ],
      "description": "Funds obligated amount"
    },
    "estimated_total": {
      "type": [
        "number",
        "null"
      ],
      "description": "Estimated total award amount"
    },
    "start_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award start date"
    },
    "expiration_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award expiration date"
    },
    "award_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award date"
    },
    "agency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Funding agency"
    },
    "program": {
      "type": [
        "string",
        "null"
      ],
      "description": "NSF program name"
    },
    "cfda_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "CFDA program number"
    },
    "transaction_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Transaction type"
    },
    "nsf_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL to NSF award search page"
    },
    "pi_email": {
      "type": [
        "string",
        "null"
      ],
      "description": "PI email address"
    },
    "co_pi": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Co-PI names"
    },
    "performance_location": {
      "type": [
        "string",
        "null"
      ],
      "description": "Performance location"
    },
    "performance_city": {
      "type": [
        "string",
        "null"
      ],
      "description": "Performance city"
    },
    "performance_state": {
      "type": [
        "string",
        "null"
      ],
      "description": "Performance state code"
    },
    "performance_zip": {
      "type": [
        "string",
        "null"
      ],
      "description": "Performance ZIP code"
    },
    "awardee_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "Awardee full address"
    },
    "abstract": {
      "type": [
        "string",
        "null"
      ],
      "description": "Award abstract"
    },
    "outcomes_report": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project outcomes report"
    },
    "publications": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Research and conference publications"
    }
  },
  "required": [
    "award_id",
    "title",
    "pi",
    "awardee",
    "awardee_city",
    "awardee_state",
    "awardee_country",
    "funds_obligated",
    "estimated_total",
    "start_date",
    "expiration_date",
    "award_date",
    "agency",
    "program",
    "cfda_number",
    "transaction_type",
    "nsf_url",
    "pi_email",
    "co_pi",
    "performance_location",
    "performance_city",
    "performance_state",
    "performance_zip",
    "awardee_address",
    "abstract",
    "outcomes_report",
    "publications"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "nsf-awards": {
      "url": "https://gateway.pipeworx.io/nsf-awards/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_award