Tools (4)

search_grants
get_grant
list_funding_sources
report_feedback

search_grants

Search for research grants across NIH Reporter, NSF Awards, and EU CORDIS.

Queries all three funding agencies in parallel and returns combined results
sorted by award amount (largest grants first). Each result includes the
funding source, award amount, principal investigators, and institution.

Examples:
search_grants(query="machine learning")
search_grants(query="cancer immunotherapy", source="nih", max_results=20)
search_grants(query="renewable energy", source="cordis")

Parameter	Type	Required	Description
`query`	`string`	required	Search query — keywords, topic, PI name, or institution.
`max_results`	`integer`	optional	Maximum number of results. (default: 10)
`source`	`any`	optional	Filter by source: nih, nsf, cordis. Omit to search all.

Request Body

{
  "query": "example"
}

get_grant

Look up a specific research grant by its ID.

If the source is known, specify it to get faster results. Otherwise,
all three sources are queried in parallel.

Examples:
get_grant(grant_id="5R01CA123456-05", source="nih")
get_grant(grant_id="2548201", source="nsf")
get_grant(grant_id="101057437", source="cordis")

Parameter	Type	Required	Description
`grant_id`	`string`	required	Grant ID (e.g. NIH project number, NSF award ID, or CORDIS reference).
`source`	`any`	optional	Source: nih, nsf, cordis. Specify to avoid searching all sources.

Request Body

{
  "grant_id": "123456789"
}

list_funding_sources

List all registered research funding data sources and their status.

Shows which funding agencies are available and whether they are enabled.

Examples:
list_funding_sources()

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/research-funding/search_grants" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/research-funding/search_grants",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())