LLM Broker
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
One key, every model: measured scores and live prices, routed per request to the cheapest fit.
| Author | net.llm-broker |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 379 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"LLM Broker": {
"url": "https://api.llm-broker.net/api/v1/broker/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (8)
list_modelsread-onlyModels on the broker with benchmark scores per category (0–1, measured by us), price per 1M tokens (default USD, any currency from GET /api/v1/broker/currencies) and regions. Filter by category, region and price; sorted by score in the category, else by price.
Parameters:
limit— integerregion— stringcategory— stringcurrency— string — ISO 4217 code, default USDmax_price_per_mtok— number — Max output price per 1M tokens, in currency
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_modelread-onlyOne model from list_models by id: measured scores per category, price per 1M tokens (default USD), regions, context and capabilities.
Parameters:
id(required) — stringcurrency— string — ISO 4217, default USD
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
recommend_modelread-onlyPicks from the published catalog (our own benchmark scores, list prices): best = highest score in the category, best_value = score per output price, plus alternatives. Only measured models are recommended. Returns chat_arguments for that model and a routing object to let the broker pick per request.
Parameters:
category(required) — stringregion— stringcurrency— string — ISO 4217, default USDmin_score— numbercapabilities— arraymax_price_per_mtok— number — Max output price per 1M tokens, in currency
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
estimate_costread-onlyCost estimate at list price for a model and token counts, in your currency. The bill follows the offer the router actually picks (broker.cost in the chat result).
Parameters:
model(required) — stringcurrency— string — ISO 4217, default USDinput_tokens— integeroutput_tokens— integer
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
chatSends messages to the broker (OpenAI chat completions). model defaults to `taylor` (strongest measured model); any id from list_models works. routing sets criteria per request, e.g. {"category": "coding", "level": "best"}. Needs Authorization: Bearer ast_sk_… — billed like the REST API.
Parameters:
model— stringprompt— string — Shortcut for a single user messagerouting— objectmessages— arraymax_tokens— integer
Hints: read-only no · destructive not declared · idempotent not declared · open-world yes
get_balanceread-onlyBalance, credit limit and spend this month (CHF, the book currency), billing mode and payment currency of the account behind Authorization: Bearer ast_sk_….
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
report_outcomeTell the broker if the answer to a request worked for your task — request_id comes from broker.receipt of every chat answer. Outcomes appear per model in list_models as reported (failures_30d / outcomes_30d), so the scores are checked against real tasks. No refund, no price change.
Parameters:
request_id(required) — stringoutcome(required) — stringreason— string
Hints: read-only no · destructive no · idempotent yes · open-world no
create_accountCreates a card checkout (Stripe) for a new broker account — same as POST /api/v1/broker/accounts. Give checkout_url to your human; after payment the API key is shown exactly once at status_url (GET, poll until 200). topup: amount 10/25/50, monthly: limit 50/100/250 (USD/EUR/CHF; other currencies: GET /api/v1/broker/currencies). Omit category and level to choose per request.
Parameters:
billing(required) — stringlevel— stringlimit— integer — monthly credit limit in currencyamount— integer — topup amount in currencycategory— string — optional, with level: a fixed performance promisecurrency— string
Hints: read-only no · destructive no · idempotent not declared · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.