MCP-server

Verbind elke Model Context Protocol-client met Api.Airforce — gebruik onze modellen, afbeeldingen, de modellijst en je saldo als MCP-tools, afgerekend op je account.

Wat is MCP?

Het Model Context Protocol (MCP) laat AI-agentclients — zoals Claude Desktop, Cursor of elke MCP-compatibele app — externe diensten als tools aanroepen. Api.Airforce draait een externe MCP-server zodat deze clients onze modellen rechtstreeks kunnen gebruiken.

Endpoint & transport

De server spreekt JSON-RPC 2.0 over Streamable HTTP op één endpoint, protocolversie 2025-06-18. Streaming-antwoorden worden geretourneerd wanneer je de header Accept: text/event-stream meestuurt.

POST https://api.airforce/mcp

Authenticatie

Stuur je Api.Airforce-API-sleutel — of een OAuth 2.0-bearertoken — in de Authorization-header. Niet-geauthenticeerde verzoeken geven 401 met een WWW-Authenticate-challenge die naar onze OAuth-metadata verwijst, zodat compatibele clients de OAuth-flow automatisch kunnen starten.

Voor OAuth-tokens zijn de relevante scopes profile (voor get_balance), chat (voor chat_completion) en images (voor generate_image).

Een client verbinden

De meeste clients accepteren een externe MCP-server-URL plus een bearertoken. Een typische configuratie ziet er zo uit:

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

Je kunt de verbinding handmatig controleren met een JSON-RPC initialize-aanroep:

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"}}}'

Beschikbare tools

Roep tools/list aan om ze tijdens runtime te ontdekken. Er zijn vier tools beschikbaar:

list_models

Toont de beschikbare modellen met prijzen en capability-flags.

get_balance

Geeft je pay-as-you-go-saldo (in US-cent) en huidige plan terug. Vereist de profile-scope voor OAuth-tokens.

chat_completion

Voert een OpenAI-compatibele chat completion uit. Afgerekend op je account net als POST /v1/chat/completions.

generate_image

Genereert een afbeelding. Afgerekend op je account net als 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"}'

Facturatie

chat_completion en generate_image worden op je account afgerekend tegen dezelfde tarieven als de REST-API — er is geen aparte MCP-prijs. list_models en get_balance zijn gratis.

Discovery

Er wordt een machineleesbare server card gepubliceerd voor automatische ontdekking:

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