Ukri Gtr MCP server

@pipeworx/ukri-gtr

UKRI Gateway to Research MCP — every research grant awarded by the UK's seven research councils (EPSRC, MRC, BBSRC, NERC, ESRC, AHRC, STFC) plus Innovate UK: who was funded, for what, how much, and when. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.

Tools

• gtrsearchprojects(query, funder?, status?, search_field?, limit?, page?) — free-text search over UK grants; returns grant reference, title, status, funding council, grant category, lead department and funding period.
• gtrgetproject(project) — one project by GtR GUID or by human grant reference (EP/T022159/1, 10045762). Follows the FUND and LEADORG links to return the award value in pounds**, the lead organisation and its address, the principal investigators, and the full abstract / technical abstract / potential-impact text.
• gtrsearchorganisations(name, limit?, page?) — find funded UK institutions by name; returns organisation id, name, postcode and region.
• gtrorganisationprojects(organisation, funder?, status?, limit?, page?) — one institution's funding portfolio, by organisation id or by name.
• gtrsearchpublications(query, search_field?, limit?, page?) — journal articles and papers grant holders reported as outcomes; returns DOI, PubMed id, journal, date and the originating project id.

Auth

None. Keyless and unmetered — no key, account or registration.

Two headers are mandatory and are set by the pack: Accept: application/vnd.rcuk.gtr.json-v7 (the vendored media type; a plain Accept: application/json gets you the wrong representation) and a normal browser User-Agent.

Data sources

• API root: https://gtr.ukri.org/gtr/api
• Projects: https://gtr.ukri.org/gtr/api/projects?q=cancer&s=10&p=1
• Single project: https://gtr.ukri.org/gtr/api/projects/{guid}
• Funds (award values): https://gtr.ukri.org/gtr/api/funds/{guid}
• Organisations: https://gtr.ukri.org/gtr/api/organisations?q=imperial+college&s=10&f=org.n
• Organisation portfolio: https://gtr.ukri.org/gtr/api/organisations/{guid}/projects
• Publication outcomes: https://gtr.ukri.org/gtr/api/outcomes/publications?q=cancer&s=10
• Human-facing site: https://gtr.ukri.org

Gotchas

The page-size parameter s is rejected outside 10–100 — s=1 returns HTTP 400 Page size cannot be less than 10, s=200 returns Page size cannot be greater than 100, so the pack clamps every request into that band and slices the result down to the caller's limit. The award value is not on the project object: money lives on the fund reached through links.link[] where rel === 'FUND', and gtrgetproject follows that link (plus LEADORG and PIPER) so an agent asking what a grant was worth gets an answer in one call — a fund's amount can legitimately be 0. The project's own start and end fields are null on essentially every record (0 of 100 populated in a sample), so the pack takes the funding period from the FUND link's start/end instead; both are epoch milliseconds and are emitted as ISO dates. The collection key in the response envelope changes per endpoint — project, organisation, person, fund, publication — and the links.link[] array is large and useless to a model, so it is stripped from all output and used only internally.

Shortened. The full README is on GitHub.