Kyma API

Kyma API MCP Server

Kyma API é um gateway de API para LLMs que roteia uma chave para mais de 100 modelos e publica uptime medido por modelo.
Todos os modelos atrás de um único endpoint, com rankings públicos e um limite de gastos que você define.
https://mcp.kymaapi.com/mcp

Instalação · Ferramentas · Segurança e gastos · Exemplos · Solução de problemas · Registros

Kyma API é um gateway de LLM: um endpoint compatível com OpenAI (além de um compatível com Anthropic) na frente de modelos abertos e de ponta, com uptime medido por modelo a partir de tráfego real e sondas agendadas. Este servidor oferece a qualquer cliente MCP o catálogo ao vivo, preços, rankings, uptime e seus próprios gastos como ferramentas de leitura, além de uma ferramenta de chat protegida por um limite de gastos por conexão.

• Hospedado, remoto, login com OAuth. HTTP com streaming com OAuth 2.1, PKCE e registro dinâmico de clientes. Nenhuma chave de API é colada no cliente.
• Uma chave dedicada por conexão. Separada das suas chaves de API REST, limitada a US$ 10 por 30 dias por padrão (ajustável de US$ 1 a US$ 500 na tela de aprovação ou em kymaapi.com/integrations), revogável a qualquer momento.
• Ferramentas de leitura nunca cobram. Catálogo, preços, rankings, uptime, créditos, gastos, seu uso e suas solicitações são gratuitos para consultar e aprovados automaticamente pela maioria dos clientes.
• send_message é precificado antes de gastar. O cliente deve permitir primeiro; max_cost_usd é aplicado derivando um max_tokens que se ajusta ao teto a partir do preço do catálogo, então uma chamada acima disso é recusada antes que qualquer coisa seja enviada. Cada resposta informa quanto a chamada custou, quanto foi gasto e o limite.
• Uptime medido, não uma promessa. get_model_uptime retorna a taxa de 30 dias por modelo de kymaapi.com/status. Se uma rota falhar no meio da solicitação, a Kyma tenta novamente o mesmo modelo em outra rota.
• Um endpoint somente leitura para revisores. https://mcp.kymaapi.com/mcp/readonly aceita os mesmos tokens, mas mantém apenas escopos de leitura para a solicitação: sem send_message, sem set_low_balance_alert, independentemente do que foi aprovado na concessão. Metadados: /.well-known/oauth-protected-resource/mcp/readonly.
• Além do chat. A mesma chave Kyma cobre conversão de fala para texto, texto para fala, embeddings, rerank, imagem e vídeo por meio da API REST; list_models mostra todos eles.

Instalação

claude mcp add --transport http kyma https://mcp.kymaapi.com/mcp

{ "mcpServers": { "kyma": { "url": "https://mcp.kymaapi.com/mcp" } } }

{ "servers": { "kyma": { "type": "http", "url": "https://mcp.kymaapi.com/mcp" } } }

# ~/.codex/config.toml
[mcp_servers.kyma]
url = "https://mcp.kymaapi.com/mcp"

codex mcp login kyma

{ "mcpServers": { "kyma": { "url": "https://mcp.kymaapi.com/mcp", "type": "streamableHttp" } } }

gemini extensions install https://github.com/kyma-api/kyma-mcp-plugin

{ "mcpServers": { "kyma": { "command": "npx", "args": ["-y", "@kyma-api/mcp-server"] } } }

Ferramentas

18 ferramentas. 16 aparecem em uma conexão padrão; list_keys e set_low_balance_alert aparecem quando seus escopos opcionais são concedidos na tela de aprovação.

Toda resposta de send_message carrega cost, spent_usd e spend_cap_usd, além de structuredContent com o modelo que a atendeu e as rotas tentadas. get_spend mostra o que resta antes de você chamá-la.

Segurança e gastos

• O que uma conexão pode fazer: ler o catálogo, preços, rankings, uptime, seu saldo e os gastos desta conexão; enviar conclusões de chat até seu limite; com escopos opcionais, listar suas chaves mascaradas e definir um alerta de saldo baixo.
• O que ela nunca pode fazer: criar ou excluir chaves de API, alterar cobrança ou métodos de pagamento, comprar créditos, registrar contas ou ver internals do provedor. Esses escopos não existem neste servidor.
• Limite de gastos: cada conexão recebe uma chave dedicada com seu próprio limite, US$ 10 por 30 dias por padrão, ajustável de US$ 1 a US$ 500. O limite é aplicado no servidor; quando é atingido, send_message retorna um erro até que a janela seja redefinida ou você aumente o limite em kymaapi.com/integrations.
• Tokens e chaves: tokens de acesso duram 7 dias, tokens de atualização 90 dias e são rotacionados no uso; chaves de conexão são armazenadas com hash (SHA-256) e podem ser revogadas sem tocar nas suas chaves de API REST.
• Injeção de prompt: a saída do modelo que chega ao seu agente é texto não confiável. Mantenha o prompt de confirmação do seu cliente ativado para send_message e não deixe o agente colar chaves ou saldos em outras ferramentas.
• Dados: os logs de solicitações são mantidos por 90 dias para reconciliação de cobrança e tratamento de abuso, depois excluídos. A Kyma não treina com dados de clientes. Privacidade: kymaapi.com/privacy.

Habilidades

Três habilidades ensinam um agente a usar bem as ferramentas: pick-a-model (comparar preço, uptime medido e adequação), check-spend-and-credits (saldo, limite, restante, data de redefinição), send-a-test-completion (uma chamada cobrada, somente após um Allow explícito). Elas ficam em skills/ e são instaladas em qualquer agente que leia habilidades:

npx skills add kyma-api/kyma-mcp-plugin

Exemplos

Prompts que você pode colar após conectar:

• "Quais modelos abaixo de US$ 1 por milhão de tokens de saída têm o melhor uptime de 30 dias?"
• "Recomende um modelo e configuração para o Cline e depois mostre seu preço."
• "Quanto do orçamento desta conexão resta e quando ele é redefinido?"
• "Envie 'resuma isso em uma linha' para qwen-3.6-plus e me diga quanto custou."
• "Mostre os principais aplicativos nos rankings da Kyma esta semana."

Solução de problemas

• Loops de login ou "falha no conector": remova a conexão e adicione novamente; o token armazenado no cliente pode pertencer a uma conexão revogada. Verifique kymaapi.com/integrations para a lista ativa.
• send_message diz que o limite foi atingido: aumente o limite em kymaapi.com/integrations ou aguarde a redefinição da janela de 30 dias; get_spend mostra a data.
• Uma ferramenta retorna 403 escopo insuficiente: a conexão foi aprovada sem esse escopo opcional. Reconecte e marque-o na tela de aprovação.
• A ponte stdio não consegue fazer login: defina KYMA_MCP_KEY como uma chave MCP da Kyma (km-…) criada em kymaapi.com/integrations; chaves REST kyma-… são rejeitadas de propósito.
• Conexões remotas caem: alguns clientes precisam reconectar após longos períodos ociosos; o servidor em si não tem estado.

Registros e marketplaces

• Registro oficial MCP: com.kymaapi/kyma (server.json neste repositório, publicado com mcp-publisher, namespace verificado por DNS em kymaapi.com)
• Smithery: kyma-api/kyma
• Ponte stdio npm: @kyma-api/mcp-server
• Galeria de extensões do Gemini CLI: gemini-extension.json e o tópico do repositório gemini-cli-extension
• Enviados, aguardando revisão: Cursor Marketplace, xAI Grok Build marketplace, Docker MCP Catalog, Cline Marketplace, mcp.so

Sobre a Kyma API

A Kyma é um gateway de API para LLMs: modelos abertos e de ponta, um endpoint, pague por token, com failover automático entre provedores e uptime medido por modelo publicado em kymaapi.com/models. Novas contas começam com crédito gratuito.

• Site: https://kymaapi.com · Página deste servidor: https://kymaapi.com/mcp · Documentação: https://docs.kymaapi.com · Status: https://kymaapi.com/status
• Suporte: hello@kymaapi.com · Abuso: report@kymaapi.com
• Changelog: CHANGELOG.md · Licença: MIT