Documentación

Cómo conectar tu agente a las herramientas MCP a través de Obolo: un endpoint, una API key por API, pago por llamada desde un saldo prepago, con topes de gasto y logs de auditoría. Borrador público, 2026.

Quickstart

Cuatro pasos para pasar de cero a tu primera llamada de herramienta: (1) cargá saldo en tu wallet prepaga; (2) agregá una conexión MCP por cada API que quieras usar; (3) generá una key `obl_…` para esa conexión; (4) tu agente llama `tools/call` contra el endpoint. El costo de cada llamada se descuenta del saldo. onboarding, catalog.

Conectar

Cada API tiene su propio endpoint MCP. La conexión es Streamable HTTP + JSON-RPC 2.0, autenticada con tu key `obl_…` en el header `Authorization`. Reemplazá `{serverId}` por el id del servidor que ves en su ficha del catálogo:

{
  "mcpServers": {
    "example-api": {
      "type": "streamable-http",
      "url": "https://api.obolo.dev/mcp/{serverId}",
      "headers": {
        "Authorization": "Bearer obl_live_xxxxxxxxxxxx"
      }
    }
  }
}

// JSON-RPC 2.0 over Streamable HTTP
POST https://api.obolo.dev/mcp/{serverId}
Authorization: Bearer obl_live_xxxxxxxxxxxx
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "geocode.forward",
    "arguments": { "query": "Buenos Aires" }
  }
}

Autenticación y keys

Las keys son por API: una key `obl_…` da acceso a una sola conexión, con su propia vista de herramientas y su propio tope de gasto. Eso acota el radio de impacto si una key se filtra —una key comprometida no puede gastar en otras APIs ni pasar su tope— y te deja rotar cada una por separado. security.

Facturación

El saldo es prepago y la medición es por llamada: cada `tools/call` con éxito descuenta el precio de esa herramienta del saldo de la org. Cuando la key alcanza su tope de gasto, el gateway responde 402/429 y no cobra de más. El saldo se puede fondear con Stripe, USDC prepago o x402: x402.

// key over its spend cap → charge refused, nothing overspent
HTTP/1.1 429 Too Many Requests

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": { "code": -32003, "message": "spend cap reached" }
}

Niveles de verificación

Cada servidor tiene un nivel de confianza. Nivel “crawled” (tier 1): indexado desde un directorio público, sólo metadatos, sin verificación de propiedad. Nivel “verified” (tier 2): propiedad probada por DNS + registro, y esquema declarado que pasó análisis estático con un hash canónico estable (protección contra drift). Elegí el nivel que tu caso de uso requiera. glosario.

Publicar

¿Sos publisher? Podés listar o reclamar tu servidor, ponerle precio y cobrar tu 80% con Obolo como comercio registrado. La guía completa cubre reclamar por DNS-TXT, precio por llamada, alcanzar el nivel verified y liquidar por Stripe/USDC.

Cómo monetizar un servidor MCP →

Referencia

Compare · MCP gateway · Publisher · Operator · Catalog

Dudas: hola@obolo.dev