MCP-server

UberLLM is een MCP-server op https://api.uberllm.dev/mcp. Een agent die ermee verbonden is, kan modellen weergeven, een verzoek prijzen, afbeeldingen maken en bewerken, video's maken en uw saldo controleren, zonder HTTP-aanroepen te schrijven.

Het staat vermeld in de officiële MCP Registry als dev.uberllm/mcp, zodat clients die de registry lezen het op naam kunnen toevoegen.

Het gebruikt het Streamable HTTP transport. Meld u aan met dezelfde API key die u gebruikt voor /v1, verzonden als Authorization: Bearer ull_.... Een tool call wordt gefactureerd, beperkt en geweigerd precies zoals hetzelfde verzoek aan de API: dezelfde prijzen, dezelfde per-key bestedingslimieten, en mislukte verzoeken kosten niets.

Claude Code

Vervang $KEY door je API key, of stel KEY eerst in je shell in:

claude mcp add --transport http uberllm https://api.uberllm.dev/mcp --header "Authorization: Bearer $KEY"

Voeg --scope user toe om het in elk project te gebruiken. Voer claude mcp list uit om te controleren of het verbonden is.

Claude Desktop

Claude Desktop maakt verbinding met een externe server met een sleutel via mcp-remote (vereist Node.js). Open Instellingen → Ontwikkelaar → Config bewerken en voeg toe:

{
  "mcpServers": {
    "uberllm": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.uberllm.dev/mcp", "--header", "Authorization:${UBERLLM_AUTH}"],
      "env": { "UBERLLM_AUTH": "Bearer ull_your_key_here" }
    }
  }
}

De header heeft expres geen spatie na :: op Windows citeert Claude Desktop geen spaties binnen args. Herstart Claude Desktop na het opslaan.

Cursor en andere clients

Clients die een mcpServers bestand lezen (bijvoorbeeld Cursor's ~/.cursor/mcp.json), accepteren:

{
  "mcpServers": {
    "uberllm": {
      "url": "https://api.uberllm.dev/mcp",
      "headers": { "Authorization": "Bearer ull_your_key_here" }
    }
  }
}

Hulpmiddelen

Hulpmiddel	Wat het doet	Kosten
`list_models`	Modellen die je nu kunt aanroepen, met hun prijs. `type` is `chat`, `image`, `video` of `music`; `search` toont modellen waarvan de id of naam de woorden bevat.	Nee
`get_model`	Eén model: de prijs en, voor een mediamodel, `parameters`, een JSON Schema van de opties die de aanvragen accepteren.	Nee
`quote`	Controleert een aanvraag voor afbeelding, video, muziek of tekst-naar-spraak tegen het model en prijst deze, zonder iets te maken. Retourneert `cost_usd`, de vermelde prijs, en `max_cost_usd`, wat wordt vastgehouden terwijl het draait en het maximale bedrag dat wordt gefactureerd.	Nee
`generate_image`	Maakt afbeeldingen van een prompt. Retourneert links en `usage.cost_usd`. Met `return_image: true` komen de afbeeldingen ook terug in het antwoord.	Ja
`edit_image`	Wijzigt de afbeelding in `image_url` (of de afbeeldingen in `input_images`) volgens de prompt. Gebruik een bewerkingsmodel, zoals een waarvan de id eindigt op `-edit`.	Ja
`start_video`	Start een video en retourneert een job. Stuur `idempotency_key` zodat een nieuwe poging nooit een tweede video start of betaalt.	Ja, wanneer de video is gemaakt
`get_job`	Een video- of muziekjob: status, voortgang en, zodra deze is gelukt, de bestandslinks en kosten.	Nee
`wait_job`	Wacht tot een job eindigt, tot `timeout_seconds` (maximaal 50). Als `done` `false` is, roep het dan opnieuw aan.	Nee
`balance`	Wat je nu kunt uitgeven en wat wordt vastgehouden voor aanvragen en jobs die nog lopen, in Amerikaanse dollars.	Nee

Opties die een model vermeldt in zijn parameters schema (bijvoorbeeld duration_seconds, resolution of aspect_ratio) gaan in options op quote, generate_image, edit_image en start_video. Stuur max_cost (Amerikaanse dollars) naar een tool die kosten maakt om alles te weigeren wat meer zou kunnen kosten.

Een video duurt van ongeveer 30 seconden tot enkele minuten. De gebruikelijke workflow is get_model, quote, start_video, daarna wait_job totdat de status succeeded, failed, canceled of expired is.

Bestanden

Resultaatlinks (/v1/media/artifacts/...) hebben dezelfde API-sleutel nodig in de Authorization header om te downloaden. Bestanden worden bewaard gedurende ongeveer 3 uur nadat een taak is voltooid; afbeeldingslinks gedurende ongeveer 15 minuten. Zie Een video of afbeelding maken voor de details van elk verzoek.

Fouten

Wanneer de API een oproep weigert, antwoordt de tool met een foutresultaat dat de eigen boodschap en code van de API bevat, bijvoorbeeld insufficient_credits of max_cost_too_low. De codes zijn die in [Fouten]](./errors). Een verzoek zonder geldige sleutel wordt beantwoord met 401 voordat enige tool draait.

Controleer de verbinding

curl https://api.uberllm.dev/mcp \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'