`get_opportunity`

Pack: grants-gov · Endpoint: https://gateway.pipeworx.io/grants-gov/mcp

Fetch full details for a Grants.gov opportunity by ID. Returns synopsis text, eligibility, award ceiling/floor, attachments, contact info, and version history.

Parameters

Name	Type	Required	Description
`opportunity_id`	number	yes	Numeric opportunity ID (returned by search_opportunities as “id”)

Example call

Arguments

{
  "opportunity_id": 381934
}

curl

curl -X POST https://gateway.pipeworx.io/grants-gov/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_opportunity","arguments":{"opportunity_id":381934}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_opportunity', {
  "opportunity_id": 381934
});

Response shape

Always returns: id, number, title, agency_code, agency, synopsis, eligibility, award_ceiling, award_floor, estimated_funding, expected_awards, funding_instruments, funding_categories, applicant_types, cfdas, posting_date, response_date, closing_date_desc, archive_date, contact_name, contact_email, contact_phone, attachments, grants_gov_url

Field	Type	Description
`id`	number \| null	Numeric opportunity ID
`number`	string \| null	Opportunity number
`title`	string \| null	Opportunity title
`agency_code`	string \| null	Agency code
`agency`	string \| null	Agency name
`synopsis`	string \| null	Full synopsis description text
`eligibility`	string \| null	Eligibility requirements
`award_ceiling`	number \| null	Maximum award amount
`award_floor`	number \| null	Minimum award amount
`estimated_funding`	number \| null	Estimated total funding available
`expected_awards`	number \| null	Expected number of awards
`funding_instruments`	array	List of funding instrument types
`funding_categories`	array	List of funding activity categories
`applicant_types`	array	List of eligible applicant types
`cfdas`	array	CFDA/Assistance Listing Numbers
`posting_date`	string \| null	Date opportunity was posted
`response_date`	string \| null	Response submission date
`closing_date_desc`	string \| null	Closing date description
`archive_date`	string \| null	Archive date
`contact_name`	string \| null	Agency contact person name
`contact_email`	string \| null	Agency contact email address
`contact_phone`	string \| null	Agency contact phone number
`attachments`	array	Opportunity attachments and documents
`grants_gov_url`	string \| null	Direct link to opportunity on Grants.gov

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "number",
        "null"
      ],
      "description": "Numeric opportunity ID"
    },
    "number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opportunity number"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Opportunity title"
    },
    "agency_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Agency code"
    },
    "agency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Agency name"
    },
    "synopsis": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full synopsis description text"
    },
    "eligibility": {
      "type": [
        "string",
        "null"
      ],
      "description": "Eligibility requirements"
    },
    "award_ceiling": {
      "type": [
        "number",
        "null"
      ],
      "description": "Maximum award amount"
    },
    "award_floor": {
      "type": [
        "number",
        "null"
      ],
      "description": "Minimum award amount"
    },
    "estimated_funding": {
      "type": [
        "number",
        "null"
      ],
      "description": "Estimated total funding available"
    },
    "expected_awards": {
      "type": [
        "number",
        "null"
      ],
      "description": "Expected number of awards"
    },
    "funding_instruments": {
      "type": "array",
      "description": "List of funding instrument types",
      "items": {
        "type": "string"
      }
    },
    "funding_categories": {
      "type": "array",
      "description": "List of funding activity categories",
      "items": {
        "type": "string"
      }
    },
    "applicant_types": {
      "type": "array",
      "description": "List of eligible applicant types",
      "items": {
        "type": "string"
      }
    },
    "cfdas": {
      "type": "array",
      "description": "CFDA/Assistance Listing Numbers",
      "items": {
        "type": "object",
        "properties": {
          "number": {
            "type": [
              "string",
              "null"
            ],
            "description": "CFDA number"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Program title"
          }
        }
      }
    },
    "posting_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date opportunity was posted"
    },
    "response_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Response submission date"
    },
    "closing_date_desc": {
      "type": [
        "string",
        "null"
      ],
      "description": "Closing date description"
    },
    "archive_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Archive date"
    },
    "contact_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Agency contact person name"
    },
    "contact_email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Agency contact email address"
    },
    "contact_phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Agency contact phone number"
    },
    "attachments": {
      "type": "array",
      "description": "Opportunity attachments and documents",
      "items": {
        "type": "object",
        "properties": {
          "folder": {
            "type": [
              "string",
              "null"
            ],
            "description": "Attachment folder name"
          },
          "file_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Attachment file name"
          },
          "download_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to download attachment"
          }
        }
      }
    },
    "grants_gov_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Direct link to opportunity on Grants.gov"
    }
  },
  "required": [
    "id",
    "number",
    "title",
    "agency_code",
    "agency",
    "synopsis",
    "eligibility",
    "award_ceiling",
    "award_floor",
    "estimated_funding",
    "expected_awards",
    "funding_instruments",
    "funding_categories",
    "applicant_types",
    "cfdas",
    "posting_date",
    "response_date",
    "closing_date_desc",
    "archive_date",
    "contact_name",
    "contact_email",
    "contact_phone",
    "attachments",
    "grants_gov_url"
  ]
}

Connect

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

{
  "mcpServers": {
    "grants-gov": {
      "url": "https://gateway.pipeworx.io/grants-gov/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_opportunity