mcpField
O
omni-agents-a2a

omni-agents-a2a

github.com/cheaper-inferenceAgent workflows82.3k1.0k installsUpdated today
Repository

About omni-agents-a2a

omni-agents-a2a is a skill for interacting with OmniRoute through the JSON-RPC 2.0 agent-to-agent protocol. It supports provider and model routing, quota checks, cost estimates, and health reporting.

Key features

  1. 01Smart provider and model routing
  2. 02Provider capability discovery
  3. 03Quota balance reporting
  4. 04Request cost estimation
  5. 05System health reports

Use cases

  1. 01Choose a provider and model for a prompt
  2. 02Find providers matching capability needs
  3. 03Check account quota and request cost
  4. 04Inspect system health and errors

MCP support

This skill uses OmniRoute's A2A interface over JSON-RPC 2.0; the input does not describe an MCP interface.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-agents-a2a

After installing, type/omni-agents-a2ain Claude Code to confirm it loaded.

Details

From the project README

Overview

Interact with OmniRoute via JSON-RPC 2.0 agent-to-agent protocol. 6 built-in A2A skills: smart-routing, quota-management, provider-discovery, cost-analysis, health-report, list-capabilities.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

No endpoints mapped for this area yet.

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

OmniRoute — A2A Protocol

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

OmniRoute publishes an Agent Card at /.well-known/agent.json and accepts JSON-RPC 2.0 calls at /a2a.

Discovery

curl $OMNIROUTE_URL/.well-known/agent.json

Returns Agent Card with skills, endpoints, auth scheme.

Available skills

SkillPurpose
smart-routingGiven a prompt, recommends best provider/model combo
quota-managementReports quota balance for given provider/account
provider-discoveryLists providers matching capability filters (vision, JSON mode, tools, max-context)
cost-analysisEstimates cost for a given request shape
health-reportReturns system health (circuit states, latencies, errors)

Call example (JSON-RPC 2.0)

curl -X POST $OMNIROUTE_URL/a2a \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tasks/send",
    "params": {
      "skillId": "smart-routing",
      "input": { "prompt_length": 4000, "tools": true, "vision": false }
    },
    "id": 1
  }'

Response shape

{
  "jsonrpc": "2.0",
  "result": {
    "taskId": "...",
    "status": "completed",
    "output": { "recommended_combo": "...", "reasoning": "..." }
  },
  "id": 1
}

Errors

  • -32600 → invalid request (bad JSON-RPC envelope)
  • -32601 → method not found (check method field)
  • -32602 → invalid params (check skillId against Agent Card)
  • 401 → missing/invalid OMNIROUTE_KEY

Reference

Full docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/A2A-SERVER.md

Comments

Markdown supported