Find Programs
find_programsWhich programs match these words, across institutions? The words are read in each program's name and award title, its description, and its CIP's title and definition, and the programs come back in that order (name and award matches first). Optionally one institution's UNITID, a state or a city. Each program answers with its award, its CIP code with the CIP's title and definition, its published credit figure verbatim, edition, source page and institution. Each row names its current FORM's wording source: source_url, capture_file, catalog_year and source_catalog_name are that one source's, never the record's whole span. A row whose record holds more than one form or more than one source also carries version_count, source_count, first_edition_seen and last_edition_seen, and one sentence saying so in words; a record with one form and one source carries none of them and reads exactly as it always has. The forms themselves, each with its own content and its own sources, come from the one-record get, never from a list. A record last seen in an older edition says so, because the Union keeps a record no current catalog prints.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_programs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Optional city: programs at that city's institutions | |
| limit | No | Optional page size (default 20, at most 100) | |
| query | Yes | Words, e.g. welding, nursing or computer: read in names, award titles, descriptions and the CIP's title and definition | |
| state | No | Optional two-letter state: programs at that state's institutions | |
| offset | No | Optional: the next_offset from a previous answer | |
| unitid | No | Optional: one institution's IPEDS UNITID |