Server definition

Hash: sha256:e8d4f673b5f0d73b2e7c0017748f4b5cfb0e12ba45df0c4bd58c317c2ff920c1
What it is: What a remote MCP server returned when asked what it offers: 4 tools

The blob, as servednamed by its sha256

{
  "instructions": "Routavo routes agent calls to APIs and meters them. Call discover() to see what the network can do and how Routavo picks between providers, then call() to use it. Calls are paid from a balance: top up with a card at /topup, or deposit USDC after proving a wallet at /api/wallet, or send an x402 authorization; without any of those you are on a small free tier.",
  "tools": [
    {
      "description": "Route a call to the Routavo network, meter it, and return the result. Give either a provider id from discover(), or a capability and let Routavo pick using its published routing rule. Optional max_price and max_latency_ms constrain the choice. Failed calls are recorded but cost nothing.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "arguments": {
            "additionalProperties": true,
            "description": "Arguments in the capability contract shape from discover(). Learn geocode once; every provider behind it takes the same input and returns the same output.",
            "type": "object"
          },
          "batch": {
            "description": "Instead of one arguments object, up to 50 of them for the same capability or provider. Run in parallel, each with its own receipt, one total. Failed items cost nothing and do not stop the others.",
            "items": {
              "type": "object"
            },
            "maxItems": 50,
            "type": "array"
          },
          "budget": {
            "additionalProperties": false,
            "description": "A task budget: { id, max }. Spend under this id is tracked across any number of calls, plans and batches, and a call that would take it past max is refused with code \"budget\". { id, statement: true } returns what the budget has spent and the receipts behind it.",
            "properties": {
              "id": {
                "type": "string"
              },
              "max": {
                "type": "string"
              },
              "statement": {
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "capability": {
            "description": "Capability to route on, e.g. \"geocode\". Ignored when provider is given.",
            "type": "string"
          },
          "country": {
            "description": "Two letter code for where this request is, e.g. \"FR\". A routing hint, not an argument to the API: it lets a provider that covers only that country be chosen, and keeps one that does not out of the running. Unnecessary when the arguments already carry coordinates.",
            "type": "string"
          },
          "dry_run": {
            "description": "Quote only: which provider would be chosen, at what price, with what latency, and why. Nothing is called, charged or counted.",
            "type": "boolean"
          },
          "failover": {
            "description": "Default true when routing by capability: if the chosen provider fails, the next eligible one is tried and only the one that answered is charged. Set false to fail fast.",
            "type": "boolean"
          },
          "fields": {
            "description": "Return only these output paths, e.g. [\"results.name\", \"results.lat\", \"results.lng\"]. Saves tokens; the receipt still hashes the full answer.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "idempotency_key": {
            "description": "Your own id for this call, up to 64 characters. A retry with the same key within 24 hours returns the same result and receipt and is never charged again. The output is kept for those 24 hours only because you asked for replay.",
            "type": "string"
          },
          "max_latency_ms": {
            "description": "Do not route to a provider slower than this p50",
            "type": "integer"
          },
          "max_price": {
            "description": "Do not route above this price per call, e.g. \"0.0030\"",
            "type": "string"
          },
          "max_total": {
            "description": "For a plan: do not run if the quoted total exceeds this, e.g. \"0.0100\".",
            "type": "string"
          },
          "payment": {
            "additionalProperties": false,
            "description": "Pay this one call with x402: { rail: \"x402\", payload: <PaymentPayload> }, an EIP-3009 authorization to the pay-to address for at least the price, signed by your wallet. The requirements to sign are in discover() and in any payment_required error. A facilitator verifies and settles it; the receipt carries the transaction.",
            "properties": {
              "payload": {
                "type": "object"
              },
              "rail": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "plan": {
            "description": "Instead of one call, a sequence of up to 8 steps: [{ id, capability | provider, arguments, max_price?, max_latency_ms? }]. A later step may take a value from an earlier one with { \"$ref\": \"<step id>.output.<path>\" }, e.g. { \"$ref\": \"geo.output.results[0].lat\" }. The whole plan is quoted before anything runs; with dry_run it is only quoted. Steps run in order and stop at the first failure. Each step returns its own receipt and the response carries one total.",
            "items": {
              "type": "object"
            },
            "maxItems": 8,
            "type": "array"
          },
          "provider": {
            "description": "Provider id, e.g. \"open-meteo.geocode\". Omit to route by capability.",
            "type": "string",
            "x-mcp-header": "Provider"
          },
          "quorum": {
            "description": "Ask 2 or 3 providers the same question and get an agreement score with every answer. Each provider is charged. Refused if fewer providers clear your constraints, so quote it first with dry_run.",
            "maximum": 3,
            "minimum": 2,
            "type": "integer"
          },
          "recipe": {
            "description": "A named, published plan, e.g. \"weather_for_place\". Give its arguments and it runs the steps for you, quoted first, with the last step's output on top. discover() lists recipes with their inputs and estimated price.",
            "type": "string"
          },
          "wallet": {
            "description": "Your wallet address, asserted. Attributes metering and a daily cap on the free tier; it proves nothing. To pay from a balance, prove the wallet once at /api/wallet and send the key it returns as wallet_key or as Authorization: Bearer rw_...",
            "type": "string",
            "x-mcp-header": "Wallet"
          },
          "wallet_key": {
            "description": "A wallet key (rw_...) from /api/wallet. Proves the wallet, and calls are paid from its deposited USDC balance. Prefer sending it as the Authorization: Bearer header.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "call",
      "outputSchema": null
    },
    {
      "description": "Find APIs on the Routavo network that can perform a capability. Returns each provider with its published price, measured latency, terms, and the exact argument schema for calling it, plus the rule Routavo uses to pick between them. Call this before call() when you do not already know a provider id.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "capability": {
            "description": "What you need done, e.g. \"geocode\" or \"forecast\". Omit to list everything.",
            "type": "string"
          },
          "query": {
            "description": "Free text when you do not know the capability name, e.g. \"turn an address into coordinates\" or \"will it rain tomorrow\". Matched against names, aliases, tags and descriptions; results come back ranked with a score.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "discover",
      "outputSchema": {
        "properties": {
          "count": {
            "type": "integer"
          },
          "providers": {
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "routing": {
            "type": "object"
          }
        },
        "required": [
          "providers",
          "count",
          "routing"
        ],
        "type": "object"
      }
    },
    {
      "description": "Flag a metered call for the provider to review. Takes the receipt and a short reason. The receipt must verify and must have charged something. The dispute lands in that provider's queue and is visible to Routavo. One dispute per receipt.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "reason": {
            "description": "What was wrong, in plain words. Up to 500 characters. Do not paste the response body.",
            "type": "string"
          },
          "receipt": {
            "additionalProperties": true,
            "description": "The receipt object from the call() result you are disputing.",
            "type": "object"
          }
        },
        "required": [
          "receipt",
          "reason"
        ],
        "type": "object"
      },
      "name": "dispute",
      "outputSchema": null
    },
    {
      "description": "Check a receipt returned by call(). Confirms the signature, so the provider, price, fee, and the hashes of what went in and came out are exactly what Routavo recorded. Works for anyone holding the receipt. Reveals nothing else.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "receipt": {
            "additionalProperties": true,
            "description": "The receipt object from a call() result.",
            "type": "object"
          }
        },
        "required": [
          "receipt"
        ],
        "type": "object"
      },
      "name": "verify",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:e8d4f673b5f0d73b2e7c0017748f4b5cfb0e12ba45df0c4bd58c317c2ff920c1 | sha256sum