Search Funders
crossref_search_fundersFinds funders registered in the Crossref Funder Registry by name or funder DOI. Provide funder_doi for an exact single-funder lookup — the full DOI ("10.13039/100000001"), the bare registry ID ("100000001"), or either behind a doi: or https://doi.org/ prefix — or query for name-based search. Name-query results page with offset — the nextOffset enrichment carries the value for the following page, up to offset + rows = 100000. Set include_works to true to also return a page of the most recent works funded by the matched funder; that list pages two ways, in two orders. works_offset is the simple one: newest published first, capped ten times lower at works_offset + rows = 10000. works_cursor has no ceiling and reaches the whole funded-works list, newest registered first — ordered by the date each DOI was registered with Crossref, since Crossref does not walk a publication-date sort by cursor: pass works_cursor="*" on the first call, then chain the nextWorksCursor token from each response. The two cannot be combined, and a cursor walk always starts at the most recently registered work — it cannot resume from an offset. This list also counts works funded by the funder's registry descendants, which a crossref_search_works filter on {"funder": "10.13039/"} does not; a funder_doi lookup returns those descendants' registry IDs as descendants, and the funder's own ID OR'd with each of them in the funder filter ({"funder": ",funder:,…"}) counts the same scope with date, type, or other filters. Both it and that filter count the grant DOIs a funder registers as funded works. Returns funder name, registry ID, country, and alternate names, plus, on a funder_doi lookup, the Funder Registry's own work count for the ID and the same with its descendants (descendantWorksCount), both less grant records. The Funder Registry supersedes entries, and a deprecated one answers to the same names as its successor while carrying only a fraction of its works: such a record carries replacedBy with the superseding registry ID and the response carries a notice naming it. The replacement is never followed automatically — re-run with funder_doi set to that ID to get the current entry.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "crossref_search_funders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | Maximum funders to return for name queries, or works when include_works is true (1–1000, default 10). | |
| query | No | Funder name search query, e.g. "National Science Foundation" or "Wellcome Trust" | |
| offset | No | Zero-based offset into the name-query funder list. Pass the nextOffset value from the previous response to continue. Capped at offset + rows = 100000: a page that would pass it returns the funders that fit and says so in notice, and an offset at or past it is refused. Ignored when funder_doi is set, which resolves exactly one record. | |
| funder_doi | No | Funder DOI for exact lookup — the full DOI "10.13039/100000001" (NSF) or the bare registry ID "100000001". Supersedes query when provided. | |
| works_cursor | No | Cursor token for deep paging of the funded-works list when include_works is true. Pass "*" to start the walk at the most recently registered work, then pass the nextWorksCursor value from each response. A walk runs by the date each DOI was registered with Crossref, newest first, not by publication date — Crossref does not walk a publication-date sort by cursor. Has no offset ceiling and cannot be combined with works_offset. | |
| works_offset | No | Zero-based offset into the funded-works list when include_works is true. Pass the nextWorksOffset value from the previous response to continue. Capped at works_offset + rows = 10000: a page that would pass it returns the works that fit and says so in notice, and a works_offset at or past it is refused; use works_cursor to read the whole list. Cannot be combined with works_cursor. | |
| include_works | No | When true, also return a page of works funded by the matched funder. Requires an unambiguous funder — pass funder_doi when a name query matches more than one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Guidance on a page that needs a caveat: a query nothing matched, an offset or works_offset past the end of a list that did match, a page whose offset + rows would pass one of the route offset ceilings, cut to the rows that fit (naming the rows requested and applied), a page that reaches one of those ceilings with records still unretrieved (naming the route to them), a returned funder that the Funder Registry has deprecated in favor of another entry, a funded-works row of type grant, which carries no title (naming crossref_get_work as the call that returns it), or a query or funder_doi supplied blank with nothing else to search by, so the page lists every funder unfiltered. Absent otherwise. A page needing more than one caveat carries them all in this one string. | |
| funders | No | Matching funder records | |
| nextOffset | No | Value to pass as offset on the next call for the following page of funders. Absent when this page ends the matches or reaches the 100000-record offset ceiling. | |
| fundedWorks | No | Page of works funded by the matched funder, newest first — by publication date on an offset page, by Crossref registration date on a works_cursor page. Only present when include_works is true. | |
| funderCount | No | Number of funder records returned in this page | |
| fundersTotal | No | Total funder records matching the query in Crossref | |
| nextWorksCursor | No | Value to pass as works_cursor on the next call for the following page of funded works. Present only on a page requested with works_cursor, and absent once the walk reaches the end of the works list. | |
| nextWorksOffset | No | Value to pass as works_offset on the next call for the following page of funded works. Absent when this page ends the works list, reaches the 10000-record offset ceiling, or was requested with works_cursor. | |
| fundedWorksTotal | No | Total of the matched funder's funded-works list when include_works is true: works funded by it or its registry descendants, grant records included — every grant DOI the funder and its descendants register counts as a funded work. A funder_doi lookup's descendantWorksCount is this total less those grant records. To count that scope without grants under other filters, OR the funder's ID with its descendants in a crossref_search_works funder filter with rows: 0, then subtract from totalResults the Grant count of facets {"type-name": "*"} or the totalResults of the same call with "type": "grant" added to the filter. |