Servidor MCP

Conecta cualquier cliente de Model Context Protocol a Api.Airforce — usa nuestros modelos, imágenes, la lista de modelos y tu saldo como herramientas MCP, facturado a tu cuenta.

¿Qué es MCP?

El Model Context Protocol (MCP) permite que los clientes de agentes de IA — como Claude Desktop, Cursor o cualquier app compatible con MCP — llamen a servicios externos como herramientas. Api.Airforce ejecuta un servidor MCP remoto para que estos clientes usen nuestros modelos directamente.

Endpoint y transporte

El servidor habla JSON-RPC 2.0 sobre Streamable HTTP en un único endpoint, versión de protocolo 2025-06-18. Las respuestas en streaming se devuelven cuando envías la cabecera Accept: text/event-stream.

POST https://api.airforce/mcp

Autenticación

Envía tu clave API de Api.Airforce — o un token bearer OAuth 2.0 — en la cabecera Authorization. Las solicitudes no autenticadas devuelven 401 con un desafío WWW-Authenticate que apunta a nuestros metadatos OAuth, para que los clientes compatibles inicien el flujo OAuth automáticamente.

Para los tokens OAuth, los scopes relevantes son profile (para get_balance), chat (para chat_completion) e images (para generate_image).

Conectar un cliente

La mayoría de los clientes aceptan una URL de servidor MCP remoto más un token bearer. Una configuración típica se ve así:

{
  "mcpServers": {
    "api-airforce": {
      "url": "https://api.airforce/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Puedes verificar la conexión manualmente con una llamada JSON-RPC initialize:

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

Herramientas disponibles

Llama a tools/list para descubrirlas en tiempo de ejecución. Hay cuatro herramientas disponibles:

list_models

Lista los modelos disponibles con precios e indicadores de capacidad.

get_balance

Devuelve tu saldo pay-as-you-go (en centavos de USD) y tu plan actual. Requiere el scope profile para tokens OAuth.

chat_completion

Ejecuta una chat completion compatible con OpenAI. Facturada a tu cuenta exactamente como POST /v1/chat/completions.

generate_image

Genera una imagen. Facturada a tu cuenta exactamente como POST /v1/images/generations.

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Facturación

chat_completion y generate_image se facturan a tu cuenta con las mismas tarifas que la API REST — no hay precios MCP separados. list_models y get_balance son gratis.

Descubrimiento

Se publica una tarjeta de servidor legible por máquina para el descubrimiento automático:

https://api.airforce/.well-known/mcp/server-card.json