How to Use NIH RePORTER grant search in Codex
Find funded research projects and their titles, organizations, investigators, abstracts, and award information in NIH RePORTER. Use it to build a topic or institution shortlist before examining individual grants or their linked papers.
Prompts to try with NIH RePORTER grant search in Codex
Copy an example into Codex, or ask in your own words.
Use NIH RePORTER grant search to retrieve projects about "sickle cell disease" at Johns Hopkins University, then create a data fixture in this repository using the actual returned records.
Use NIH RePORTER grant search to find University of Michigan projects about antimicrobial resistance and populate this repository's research index with their returned titles and identifiers.
Use NIH RePORTER grant search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from NIH RePORTER grant search and tell me what changed since last week.
Check NIH RePORTER grant search and summarize what you find in three bullet points.
How to set up NIH RePORTER grant search in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run NIH RePORTER grant search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "reporter-nih-gov/research-grants/search_projects", "input": { "sort": "relevance" } }'
Then paste one of the prompts above: Codex finds NIH RePORTER grant search on Spiral, shows the price and runs it.
NIH RePORTER grant search providers and prices
Spiral runs NIH RePORTER grant search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Sort | relevance, award_amount, fiscal_year, project_start_date, or project_end_date | relevance | sort |
| Limit | 1 to 50 | 10 | Projects per page. |
| Offset | 0 to 14999 | 0 | Rows to skip; pass next_offset from the previous page with the same criteria. RePORTER pages no further than offset 14,999. |
| Sort order | asc or desc | desc | Applies to every sort except relevance. |
| Pi profile ID | a number from 1 | RePORTER PI profile id from a previous result: every project of exactly that investigator. | |
| Text operator | and, or, or advanced | and | How text words combine: and (all words), or (any word), advanced (RePORTER boolean syntax). Requires text. |
| Org name exact | on or off | Match org_name exactly as RePORTER spells it, e.g. "STANFORD UNIVERSITY". Requires org_name. | |
| Exclude subprojects | on or off | Drop the component subprojects of multi-project awards (P01, U54, ...) and keep their parent records. |
Every API field of NIH RePORTER · Search projects is on its tool page: open its card above.
What can you do with NIH RePORTER grant search in Codex?
Build a research index that connects NIH-funded project summaries with recorded PubMed associations. A coding agent can add project records to your application's data model and preserve application IDs for later detail lookups.
Prepare a research partnership shortlist
Find university projects on pancreatic cancer, read their abstracts, and examine associated publication links to identify institutions doing relevant work.
Check a proposal's research context
Compare a proposed Alzheimer's disease study with funded projects, inspect overlapping research aims, and collect PubMed IDs for associated papers.
Build an institutional research brief
Find Johns Hopkins projects on malaria, summarize their stated aims and award records, and add recorded publication associations.
Support a science reporting assignment
Trace funded research on sickle cell disease from project discovery through award details to linked papers, giving a reporter a documented starting point.
Review a public research portfolio
Assemble projects on antimicrobial resistance, compare their abstracts and fiscal-year funding records, and inspect the publication links recorded for those projects.
Maintain a topic-specific evidence index
Revisit funded research on cystic fibrosis, refresh project summaries, and add newly observed PubMed associations without treating missing links as proof of no publications.
More on NIH RePORTER grant search and Codex
Overview
NIH RePORTER grant search in other agents
Questions about NIH RePORTER grant search in Codex
Can Codex use NIH RePORTER grant search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run NIH RePORTER grant search like any built-in tool.
How much does NIH RePORTER grant search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use NIH RePORTER grant search in Codex?
No. Spiral runs NIH RePORTER grant search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up NIH RePORTER grant search in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while NIH RePORTER grant search runs?
NIH RePORTER grant search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
How fresh is NIH RePORTER?
NIH generally updates its project database weekly. A scheduled review can use that weekly cycle to check for newly available or changed project records.
Does RePORTER cover every paper produced by a grant?
No. RePORTER lists publications found in PubMed or PubMed Central, so it does not cover every possible publication venue.
How reliable are the links between grants and papers?
NIH explicitly warns that publications can be linked to the wrong grant or missing altogether. A linked-paper count therefore measures recorded associations, not a grant's complete output.
Does a project's funding amount represent its lifetime budget?
RePORTER defines total project funding for a given fiscal year. Use the year attached to an award record when comparing funding with research aims or associated publications.
What identifies an individual RePORTER project record?
The application ID is the unique identifier for a project record in RePORTER. Keep that identifier when connecting a search result to its detailed award record.
Start using NIH RePORTER grant search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


