How do I install the Omniroute Monitoring skill?

Run npx skillmds@latest add pablolira-1982/omniroute-monitoring in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omniroute Monitoring safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omniroute Monitoring?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omniroute Monitoring free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omniroute Monitoring?

pablolira-1982 (@pablolira-1982) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omniroute Monitoring by pablolira-1982

Name: Omniroute Monitoring
Author: pablolira-1982

Omniroute Monitoring

Monitor OmniRoute system health, provider circuit breakers, per-provider latency (p50/p95/p99), quota usage, and set budget guards. Use when the user wants to check if the system is healthy, debug slow providers, manage spend limits, or set up oncall-style monitoring.

File contents

OmniRoute — Monitoring & Health

Requires OMNIROUTE_URL and OMNIROUTE_KEY. See entry-point SKILL for setup.

System health

curl $OMNIROUTE_URL/api/health \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Returns: uptime, memory, active connections, circuit breaker states, rate limit status, cache stats.

Unauthenticated quick check:

curl $OMNIROUTE_URL/api/health
# → {"ok":true}

Provider circuit breakers

Circuit breakers prevent traffic from hitting failing providers.

States: CLOSED (normal), OPEN (blocked), HALF_OPEN (probe mode — auto-recovers).

curl $OMNIROUTE_URL/api/monitoring/health \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Response includes circuitBreakers array with per-provider state and resetAt timestamp.

Per-provider metrics (p50/p95/p99)

curl $OMNIROUTE_URL/api/providers/metrics \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Response shape per provider:

{
  "provider": "anthropic",
  "requests": 1247,
  "successRate": 0.994,
  "latency": { "p50": 820, "p95": 2100, "p99": 3800 },
  "circuitState": "CLOSED",
  "tokensUsed": 2847000
}

Via MCP (if OmniRoute is your MCP server)

omniroute_get_health            → full system health snapshot
omniroute_get_provider_metrics  → p50/p95/p99 + circuit state per provider
omniroute_get_session_snapshot  → cost, tokens, errors for current session
omniroute_check_quota           → quota balance + percent remaining + reset time
omniroute_db_health_check       → diagnose + auto-repair database drift

Quota check

curl $OMNIROUTE_URL/api/quota \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Returns used/total tokens and requests per provider/account, with resetAt timestamps.

Budget guard (spend limit)

Set a session spending limit that degrades or blocks requests when hit:

curl -X POST $OMNIROUTE_URL/api/budget/guard \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "limitUsd": 5.00,
    "action": "degrade",
    "degradeTo": "openai/gpt-4o-mini"
  }'

action options:

degrade — switch to a cheaper model when limit is hit
block — return 429 when limit is hit
alert — continue but add X-Budget-Warning header

MCP audit log

OmniRoute logs every MCP tool call to mcp_audit table. Query via API:

curl "$OMNIROUTE_URL/api/mcp/status" \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Returns: server status, heartbeat, recent audit activity summary.

Errors

503 on health endpoint → OmniRoute is starting up; retry in 5s
Circuit breaker OPEN → provider is temporarily blocked; check resetAt to know when it auto-recovers
429 budget_exceeded → budget guard limit reached; raise limit or wait for reset

---name: omniroute-monitoringdescription: Monitor OmniRoute system health, provider circuit breakers, per-provider latency (p50/p95/p99), quota usage, and set budget guards. Use when the user wants to check if the system is healthy, debug slow providers, manage spend limits, or set up oncall-style monitoring.---# OmniRoute — Monitoring & HealthRequires `OMNIROUTE_URL` and `OMNIROUTE_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute/SKILL.md) for setup.## System health```bashcurl $OMNIROUTE_URL/api/health \ -H "Authorization: Bearer $OMNIROUTE_KEY"```Returns: uptime, memory, active connections, circuit breaker states, rate limit status, cache stats.Unauthenticated quick check:```bashcurl $OMNIROUTE_URL/api/health# → {"ok":true}```## Provider circuit breakersCircuit breakers prevent traffic from hitting failing providers.States: `CLOSED` (normal), `OPEN` (blocked), `HALF_OPEN` (probe mode — auto-recovers).```bashcurl $OMNIROUTE_URL/api/monitoring/health \ -H "Authorization: Bearer $OMNIROUTE_KEY"```Response includes `circuitBreakers` array with per-provider state and `resetAt` timestamp.## Per-provider metrics (p50/p95/p99)```bashcurl $OMNIROUTE_URL/api/providers/metrics \ -H "Authorization: Bearer $OMNIROUTE_KEY"```Response shape per provider:```json{ "provider": "anthropic", "requests": 1247, "successRate": 0.994, "latency": { "p50": 820, "p95": 2100, "p99": 3800 }, "circuitState": "CLOSED", "tokensUsed": 2847000}```## Via MCP (if OmniRoute is your MCP server)```omniroute_get_health → full system health snapshotomniroute_get_provider_metrics → p50/p95/p99 + circuit state per provideromniroute_get_session_snapshot → cost, tokens, errors for current sessionomniroute_check_quota → quota balance + percent remaining + reset timeomniroute_db_health_check → diagnose + auto-repair database drift```## Quota check```bashcurl $OMNIROUTE_URL/api/quota \ -H "Authorization: Bearer $OMNIROUTE_KEY"```Returns used/total tokens and requests per provider/account, with `resetAt` timestamps.## Budget guard (spend limit)Set a session spending limit that degrades or blocks requests when hit:```bashcurl -X POST $OMNIROUTE_URL/api/budget/guard \ -H "Authorization: Bearer $OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{ "limitUsd": 5.00, "action": "degrade", "degradeTo": "openai/gpt-4o-mini" }'````action` options:- `degrade` — switch to a cheaper model when limit is hit- `block` — return 429 when limit is hit- `alert` — continue but add `X-Budget-Warning` header## MCP audit logOmniRoute logs every MCP tool call to `mcp_audit` table. Query via API:```bashcurl "$OMNIROUTE_URL/api/mcp/status" \ -H "Authorization: Bearer $OMNIROUTE_KEY"```Returns: server status, heartbeat, recent audit activity summary.## Errors- `503` on health endpoint → OmniRoute is starting up; retry in 5s- Circuit breaker `OPEN` → provider is temporarily blocked; check `resetAt` to know when it auto-recovers- `429 budget_exceeded` → budget guard limit reached; raise limit or wait for reset

Frequently asked questions