List Grants.gov Reference Codes
grantsgov_list_referenceList the codes Grants.gov search filters accept, with labels and live opportunity counts: agencies (top level, or one agency's sub-agencies via parent_code, or matched by name via name_contains), applicant eligibility types, funding categories, funding instruments, statuses, sort options, and keyword syntax. Use the codes as grantsgov_search_opportunities inputs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic": "<topic>"
},
"name": "grantsgov_list_reference"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Entries per page; defaults to 50. Requests above the processing cap of 100 are clamped with a notice. | |
| topic | Yes | Which list to return: agencies (agency codes), eligibilities (two-digit applicant-type codes), funding_categories, funding_instruments, statuses, sort_options, or keyword_syntax. | |
| offset | No | Zero-based offset into the complete filtered list; use continuation for the next page. | |
| parent_code | No | Agencies only: list every code under this agency at any depth (e.g. HHS, DOD-DARPA). Case-insensitive. Omit for the top-level list. | |
| name_contains | No | Keep only entries whose label or code contains every word given, ignoring case, accents, and punctuation (e.g. "national science", "nih"). For agencies this searches every code, top-level and sub-agency. Works with every topic. A value with no letters or digits matches nothing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Effective page size, at most 100. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Entries returned on this page. | |
| topic | No | The topic listed. | |
| notice | No | Guidance when name_contains matched nothing, or when parent_code has no sub-agencies. | |
| entries | No | Reference entries. | |
| truncated | No | True when matching entries remain after this page. | |
| totalCount | No | Total entries matching the filters before paging. | |
| continuation | No | Complete arguments for the next grantsgov_list_reference call; absent when no entries remain. | |
| snapshot_date | No | When the live vocabulary was fetched (ISO timestamp); absent for fully static topics. | |
| reference_cache | No | Degraded reference-cache provenance; absent after a healthy refresh. |