Design Tokens
Audience accent colors, shared MCP parameters, and the response envelope shape.
Audience Colors
student · #4B90F7
operator · #F59E0B
utility · #6B7280
core · #9370F8
Shared Parameters
| Name | Type | Default | Notes |
|---|---|---|---|
research_field |
string | — | Maps to API student_field |
university |
string | — | Must exist in shortlist.json |
country |
string? | — | Filter shortlist by country |
region |
string? | — | Filter shortlist by region |
limit |
int | 5 | Page size at MCP layer (REST /recommend default 10) |
offset |
int | 0 | Slice into filtered lists |
run_id |
string | — | Collection run identifier from collect_faculty_data |
use_llm_fallback |
bool? | false | Optional discovery fallback for operator collection |
Response Envelope
{
"summary": "str — sentence for the assistant",
"data": Any | null,
"next_steps": ["tool_name", ...],
"error": { "code": "NO_DATA_YET|...", "message": "str" } | null
}
Error codes: NO_DATA_YET, NO_MATCH, NOT_FOUND, SERVICE_DOWN