omniroute --mcp

# HTTP streamable transport (port 20130)
omniroute --dev  # MCP auto-starts on /mcp endpoint

MCP Client Configuration for Claude Desktop, Cursor, Cline, and compatible MCP client setup.

---

Tool	Description
	Gateway health, circuit breakers, uptime
	All configured combos with models
	Performance metrics for a specific combo
	Switch active combo by ID/name
	Quota status per provider or all
	Send a chat completion through OmniRoute
	Cost analytics for a time period
	Full model catalog with capabilities

Tool	Description
	Dry-run routing simulation with fallback tree
	Session budget with degrade/block/alert actions
	Apply conservative/balanced/aggressive preset
	Live-test all models in a combo via a real upstream request
	Detailed metrics for one provider
	Task-fitness recommendation with alternatives
	Explain a past routing decision
	Full session state: costs, tokens, errors

Tool	Description
	Semantic cache, prompt-cache, and idempotency stats
	Flush cache globally or by signature/model

Tool	Description
	Compression settings, analytics summary, and cache-aware stats
	Configure compression mode, threshold, and runtime options
	Set Caveman, RTK, or stacked compression mode and pipeline
	List named compression combos and routing assignments
	Analytics grouped by compression combo and engine

reports MCP description compression separately under . Those values are metadata-size estimates for MCP listable descriptions (, , , and ); they are not provider usage receipts and are marked with .

Compression Engines and RTK Compression for the runtime compression model behind these tools.

and .

Scope	Tools
	get_health, get_provider_metrics
	list_combos, get_combo_metrics
	switch_combo
	check_quota
	route_request, simulate_route, test_combo
	cost_report, get_session_snapshot, explain_route
	set_budget_guard, set_resilience_profile
	list_models_catalog, best_combo_for_task
	cache_stats
	cache_flush
	compression_status, list_compression_combos, compression_combo_stats
	compression_configure, set_compression_engine
	route_request, test_combo

with:

File	Purpose
	MCP server creation and scoped tool registrations
	Stdio + HTTP transport
	API key + scope validation
	Tool call audit logging
	8 advanced tool handlers