Servidor MCP
MartLLM é um servidor MCP em https://api.martllm.com/mcp. Um agente conectado a ele pode listar modelos, precificar uma requisição, criar e editar imagens, criar vídeos e verificar seu saldo, sem escrever chamadas HTTP.
Ele está listado no [Registro MCP oficial]](https://registry.modelcontextprotocol.io/v0/servers?search=dev.uberllm) como dev.uberllm/mcp, para que clientes que leem o registro possam adicioná-lo pelo nome.
Ele usa o transporte HTTP com streaming. Faça login com a mesma API key que você usa para /v1, enviada como Authorization: Bearer ull_.... Uma chamada de ferramenta é cobrada, limitada e recusada exatamente como a mesma requisição para a API: os mesmos preços, os mesmos limites de gasto por API key, e requisições falhas não custam nada.
Preços sem chave
Para ver apenas modelos e preços, conecte-se a https://api.martllm.com/mcp/public.
Não precisa de API key e nem de conta. Ele tem três ferramentas somente de leitura: list_models,
get_model e quote (quanto custaria uma requisição). Não pode fazer nada nem
gastar dinheiro.
claude mcp add --transport http uberllm-prices https://api.martllm.com/mcp/public
Código Claude
Substitua $KEY pela sua API key, ou defina KEY no seu shell primeiro:
claude mcp add --transport http uberllm https://api.martllm.com/mcp --header "Authorization: Bearer $KEY"
Adicione --scope user para usá-lo em todos os projetos. Execute claude mcp list para checar
que ele se conectou.
Claude Desktop
Claude Desktop conecta-se a um servidor remoto com uma chave através de
mcp-remote (precisa de Node.js). Abra
Settings → Developer → Edit Config e adicione:
{
"mcpServers": {
"uberllm": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.martllm.com/mcp", "--header", "Authorization:${UBERLLM_AUTH}"],
"env": { "UBERLLM_AUTH": "Bearer ull_your_key_here" }
}
}
}
O cabeçalho não tem espaço depois de : de propósito: no Windows, Claude Desktop não coloca aspas em espaços dentro de args. Reinicie Claude Desktop depois de salvar.
Cursor e outros clientes
Clientes que leem um arquivo mcpServers (o ~/.cursor/mcp.json do Cursor, por exemplo) aceitam:
{
"mcpServers": {
"uberllm": {
"url": "https://api.martllm.com/mcp",
"headers": { "Authorization": "Bearer ull_your_key_here" }
}
}
}
Ferramentas
| Ferramenta | O que faz | Gasta |
|---|---|---|
list_models |
Modelos que você pode chamar agora, com seus preços. type é chat, image, video ou music; search mantém modelos cujo id ou nome contém as palavras. |
Não |
get_model |
Um modelo: seu preço e, para um modelo de mídia, parameters, um JSON Schema das opções que suas requisições aceitam. |
Não |
quote |
Verifica uma requisição de imagem, vídeo, música ou text-to-speech contra o modelo e a precifica, sem criar nada. Retorna cost_usd, o preço listado, e max_cost_usd, o que é retido enquanto executa e o máximo que será cobrado. |
Não |
generate_image |
Cria imagens a partir de um prompt. Retorna links e usage.cost_usd. Com return_image: true as imagens também vêm na resposta. |
Sim |
edit_image |
Muda a imagem em image_url (ou as imagens em input_images) seguindo o prompt. Use um modelo de edição, como um cujo id termina em -edit. |
Sim |
start_video |
Inicia um vídeo e retorna um job. Envie idempotency_key para que uma nova tentativa nunca inicie ou pague por um segundo vídeo. |
Sim, quando o vídeo é feito |
get_job |
Um job de vídeo ou música: status, progresso e, uma vez que foi bem-sucedido, seus links de arquivo e custo. | Não |
wait_job |
Espera até que um job termine, por até timeout_seconds (50 no máximo). Se done for false, chame-o novamente. |
Não |
balance |
O que você pode gastar agora e o que está retido para requisições e jobs ainda em execução, em dólares americanos. | Não |
Opções que um modelo lista em seu parameters schema (por exemplo duration_seconds,
resolution ou aspect_ratio) vão em options em quote, generate_image,
edit_image e start_video. Envie max_cost (dólares americanos) em uma ferramenta de gasto
para recusar qualquer coisa que possa custar mais.
Um vídeo leva de cerca de 30 segundos a vários minutos. O fluxo usual é
get_model, quote, start_video, então wait_job até que o status seja
succeeded, failed, canceled ou expired.
Arquivos
Links de resultado (/v1/media/artifacts/...) precisam da mesma API key no cabeçalho Authorization para download. Arquivos são mantidos por cerca de 3 horas depois que um trabalho termina; links de imagem por cerca de 15 minutos. Veja Crie um vídeo ou imagem para os detalhes de cada solicitação.
Erros
Quando a API recusa uma chamada, a ferramenta responde com um resultado de erro contendo a própria mensagem e código da API, por exemplo insufficient_credits ou max_cost_too_low. Os códigos são os que estão em Erros.
Você pode conectar e listar as ferramentas sem uma key, para que diretórios e inspetores MCP possam ver o que o servidor faz. Toda chamada de ferramenta precisa da sua key: sem uma, ela é respondida 401 antes que qualquer ferramenta seja executada, e nada é lido ou gasto.
Checar a conexão
curl https://api.martllm.com/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/call","params":{"name":"balance","arguments":{}}}'
Ele responde com o seu saldo. Sem a linha Authorization ele responde 401;
envie "method":"tools/list" em vez disso para ver as ferramentas sem uma chave.