Opennih MCP

Use this tool when the user asks whether the OpenNIH corpus is loaded, which official sidecars are available, or how stale the data might be — and before reporting 'no such grant', since corpus_lag_note explains that a grant added to RePORTER after the snapshot cutoff is absent here, not nonexistent. Read-only status for the deployed NIH project corpus and official sidecars. Takes no parameters; n

No parameter schema on file.

Use this tool when the user asks to find NIH grants — by topic, principal investigator, institution, NIH Institute/Center, activity code, fiscal year, or project number ('what NIH grants exist on CRISPR', 'show me Stanford's R01s in 2022', 'look up 5R01CA036569-02'). This is the primary entry point: results carry pi_profile_id, the key get_pi_profile takes. Read-only bounded search over the entity

Use this tool when the user asks which institutions get the most NIH money — 'top NIH-funded universities', 'where does NCI money go', 'rank research hospitals by R01 funding'. It also yields the entity_id that get_institution_profile, mechanism_mix and funding_growth take. Ranks institutions by competitive RPG-research NIH funding (R01 baseline), excluding intramural/contracts/centers/career/trai

Use this tool when the user asks about one researcher — 'how much NIH funding does Dr. X have', 'list this PI's grants', 'who does she collaborate with'. Run search_grants (or the find-pi-funding prompt) first: profile_id is the NIH RePORTER PI identifier carried in each result's pi_profile_id field and is not guessable. Read-only PI profile: grants, collaborators, publications, funding totals; th

Use this tool when the user asks about one named institution — 'what is Harvard's NIH funding history', 'which PIs does this university fund', 'what mechanisms does it win'. Call rank_institutions first to obtain the entity_id; search_grants results do NOT carry one. Read-only institution profile: funding history, mechanism mix, top PIs. fiscal_year_start/fiscal_year_end scope EVERY aggregate sect

Use this tool to get yearly NIH funding totals and grant counts. Returns a time series for the whole NIH, one Institute/Center, one activity code, or one institution. Use it when the user asks 'how much NIH funding was awarded in FY2020', 'how has NIH's budget changed over time', or 'plot R01 dollars by year'. total_funding spans ALL NIH mechanisms (funding_scope="all_mechanisms") and is therefore

Use this tool when the user asks how a research topic has trended over time — 'is CRISPR funding growing', 'how many p53 grants per year', 'when did NIH start funding long COVID'. Returns yearly project-row counts plus recorded award totals for a title keyword match; multi-word queries AND their words in any order. For the grants themselves use search_grants; for whole-NIH dollars use funding_tren

Use this tool when the user asks what KINDS of awards NIH (or one Institute) makes — 'how much goes to R01s vs training grants', 'what share of NCI's portfolio is centers', 'break NIH down by mechanism'. Returns counts and recorded totals per mechanism class (research / career / training / center / contract / intramural / ...) from ranking_core.classify. Use mechanism_mix instead when the question

Use this tool when the user asks how concentrated or unequal NIH funding is across institutions — 'is NIH money concentrated in a few universities', 'what share do the top 5 take', 'has inequality grown since 2000'. Returns gini, hhi, top5_share and the top-5 institutions over the competitive RPG-research scope (NULL awards excluded, never padded to $0). Bounds: fiscal years 1985-2100 with fiscal_

Use this tool when the user asks what mix of award types ONE institution wins — 'is this university mostly R01s or centers', 'how much of its NIH money is training', 'compare two schools' portfolios'. Get the entity_id from rank_institutions first. With entity_id it returns that institution's whole NIH-administered portfolio (all mechanism classes); without it, the system-wide RPG-research breakdo

Use this tool when the user asks what ONE NIH Institute funds in a topic — 'what is NCI spending on immunotherapy', 'does NIMH fund psychedelics research', 'compare NIAID and NCI on vaccines' (call it once per Institute), or ic='ALL' for every IC at once. The response states which surface produced the numbers in match_strategy: 'rcdc' (official NIH RCDC categories, FY2008+) or 'text' (project_titl

Use this tool when the user asks about the RATE of change rather than the level — 'is this university's NIH funding growing', 'what's the CAGR since 2015', 'who grew fastest'. Returns year-over-year growth plus a window CAGR for one institution (entity_id from rank_institutions) or all NIH. Both yoy_growth_pct and cagr_pct are PERCENTS (2.5905 means 2.5905%/yr, not 259%); the old fractional cagr

Use this tool when a Deep Research or connector client needs citation-shaped NIH grant hits for a natural-language query. Returns {"results": [{id, title, text, url}]} where id is the NIH project_num to pass to fetch and url is the public OpenNIH grant page. Each record is PROJECT-level, not project-year: ids are unique within a response, and the record always describes the project's CANONICAL row

Use this tool to retrieve the full record for one NIH grant after search returned its id. Returns {id, title, text, url, metadata} with url set to the public OpenNIH grant page so the client can cite it. This is the OpenAI Deep Research compatibility wrapper around the same canonical-row resolver search uses. The record is PROJECT-level, not project-year: when a project number owns several project