Model Routes

MCP tools for the Model Routes module. See the Model Routes module docs for permissions and data model.

list-model-routes

List model routes

Arguments

Argument	Type	Required	Description
project_id	string	no	Project ID (required if not using project key auth)
limit	number	no	Results per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offset	number	no	Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

create-model-route

Create a model route

Arguments

Argument	Type	Required	Description
project_id	string	no	Project ID (required if not using project key auth)
name	string	yes	Human-readable name, unique per project
targets	array<object>	yes	Ordered failover targets. Position is priority: target 0 is tried first, and a retryable failure falls through to the next target.
retry_on	array<string>	no	Which failure classes are failover-eligible. A failure whose class is not listed (and every deterministic failure — 400-class, auth, content policy) fails the generation immediately instead of spending another target's budget.
failure_threshold	number	no	Consecutive retryable failures after which a target is skipped for cooldown_seconds. Breaker state is in-process per node and keyed by (provider, model), so it is shared by every route pointing at the same backend.
cooldown_seconds	number	no	How long a tripped target is skipped before being probed again

get-model-route

Get a model route

Arguments

Argument	Type	Required	Description
route_id	string	yes	Model route ID

update-model-route

Update a model route

Arguments

Argument	Type	Required	Description
route_id	string	yes	Model route ID
name	string	no	New name (unique per project)
targets	array<object>	no	Replacement target list (ordered)
retry_on	array<string>	no	—
failure_threshold	number	no	—
cooldown_seconds	number	no	—

delete-model-route

Delete a model route

Arguments

Argument	Type	Required	Description
route_id	string	yes	Model route ID