BitBusca › Desenvolvedores › Servidor MCP (conector para IAs)

As bases da BitBusca dentro da sua IA: pergunte em português

Ligue o servidor MCP da BitBusca no Claude, no ChatGPT, no Cursor ou em qualquer cliente MCP e peça em português: "quais editais de limpeza abriram em MS hoje?", "confira este CNPJ", "tem intimação nova para a OAB MS 00000?".

Hoje: Abrir cinco sistemas para conferir um CNPJ, uma OAB e um edital, ou escrever uma integração para cada um. Com a API: Ligue uma URL no Claude, no ChatGPT ou no Cursor e peça em português: a IA chama a API e responde com dado real.

O custo de cada ferramenta é o da rota · escopo conforme as ferramentas usadas · planos a partir de R$ 19,90/mês. Chave de teste grátis.

Configurar no Claude Desktop, Cursor ou outro cliente MCP

{
  "mcpServers": {
    "bitbusca": {
      "url": "https://api.bitbusca.net/api/v1/mcp",
      "headers": { "Authorization": "Bearer bk_test_SUA_CHAVE" }
    }
  }
}

Você: tem edital aberto de material de limpeza em MS?

IA (usando bitbusca): Encontrei 12 editais abertos.
O primeiro é um pregão eletrônico da Prefeitura de
Exemplo, valor estimado R$ 184.500,00, propostas até
12/11 às 9h. Quer que eu analise o edital?

Exemplo fictício, formato resumido. Referência completa: OpenAPI.

Por que integrar

Uma URL, as bases todas — Consultas, empresas, DJEN, licitações, advogados e imóveis como ferramentas da IA.
Mesma chave e cobrança — Cada ferramenta gasta o mesmo que a rota da API, no mesmo pool.
Teto por chave — Dê à IA uma chave só com os escopos que ela precisa e teto diário de créditos.
Vibecoding — No Cursor ou no Claude Code, a IA lê o OpenAPI e escreve a integração por você.

Para quem é

Advogados no Claude ou no ChatGPT — Abrir outro sistema para ver as intimações do dia. Pergunte à IA se há intimação nova para a sua OAB.
Vibecoders (Lovable, Cursor, Bolt) — Não quer aprender a ler documentação de API. Cole a URL e peça a tela em português.
Quem monta agentes — Agente sem acesso a dado brasileiro de verdade. CNPJ, OAB, edital e publicação como ferramentas, com custo por crédito.

As ferramentas que a IA ganha

consultas — CPF, telefone, nome, placa, CNPJ e CEP: a IA confere a pessoa, o veículo ou a empresa.
empresas — Lista de empresas por ramo e cidade, para prospecção.
juridico — Publicações do DJEN por OAB, parte ou processo, e o prazo em dias úteis.
licitacoes — Editais abertos por palavra e UF, com a análise por IA.
advogados — A ficha do advogado pela inscrição na OAB.
imoveis — A ficha do lote nas cidades atendidas (7 hoje, outras em breve).

O que entrega

Ferramentas para consultas (CPF, CNPJ, placa…), empresas, DJEN, licitações, advogados e imóveis
As ferramentas chamam a mesma API REST: mesma cobrança, escopo, cota e log
Transporte Streamable HTTP, sem sessão

Endpoints e custo

POST /v1/mcp — Servidor MCP (Streamable HTTP); chave no cabeçalho ou em ?token=
GET /v1/openapi.json — OpenAPI 3.1 de todas as rotas /v1 (público) (grátis)

Limites e proteção

Cada ferramenta gasta o mesmo que a rota REST correspondente, no mesmo pool e com os mesmos tetos diários.
Clientes que não aceitam cabeçalho podem mandar a chave em ?token= — só no MCP. Prefira uma chave com escopo restrito e teto diário para isso.
Comece com a chave de teste (dados fictícios) para ver as ferramentas funcionando.

Casos de uso

Advogados no Claude ou ChatGPT — Pergunte pelas intimações do dia sem abrir outro sistema.
Vibecoding no Cursor — A IA lê o OpenAPI e escreve a integração por você.
Agentes — Seu agente confere CNPJ, OAB e edital como ferramenta.

Prompt para Lovable, Cursor ou Bolt

Ligue o servidor MCP da BitBusca nesta IA usando a URL https://api.bitbusca.net/api/v1/mcp e a minha chave no cabeçalho Authorization. Depois liste as ferramentas disponíveis e me diga o que cada uma faz e quanto custa em créditos.

Use a API da BitBusca (base https://api.bitbusca.net/api). A especificação OpenAPI está em https://api.bitbusca.net/api/v1/openapi.json.
Autentique com o cabeçalho "Authorization: Bearer <chave>", lendo a chave da variável de ambiente BITBUSCA_API_KEY.
Nunca coloque a chave no código do navegador: faça as chamadas por uma função de servidor (edge function, API route ou backend).
Trate os erros pelo campo "code" da resposta: 402 NO_CREDITS (sem créditos), 429 RATE (respeite o cabeçalho Retry-After), 429 COTA_DIARIA (teto do dia atingido), 404 NOT_FOUND (mostre "nada encontrado", não é cobrado).
Comece com a chave de teste (bk_test_…), que devolve dados fictícios e não gasta créditos.

Perguntas frequentes

Funciona no ChatGPT?

Funciona em clientes que aceitam servidor MCP remoto por URL. Onde não dá para pôr cabeçalho, use ?token= com uma chave de escopo restrito e teto diário.

O MCP custa à parte?

Não. Está em todos os planos de desenvolvedor; cada ferramenta gasta o mesmo que a rota da API. Com a chave de teste, as ferramentas devolvem dados fictícios.

A IA pode gastar todos os meus créditos?

Dê a ela uma chave própria com teto diário de créditos (limiteDia) e só os escopos que ela precisa. Passou do teto, a chave para até o dia seguinte.

Preciso saber programar?

Não. Cole a configuração do topo no seu cliente MCP e converse em português. A chave de teste deixa errar à vontade, sem gastar nada.

Outras APIs

API de CPF — Cadastro da pessoa física a partir do CPF, em JSON. (1 crédito por CPF)
API de telefone — Titular e endereço a partir do número com DDD. (1 crédito por número)
API de busca por nome — Pessoas encontradas pelo nome, com dados para separar homônimos. (1 crédito por busca)
API de placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
API de CNPJ — Ficha da empresa com quadro de sócios, pelo CNPJ. (1 crédito por CNPJ)
API de empresas (leads B2B) — Empresas por CNAE, cidade, porte e abertura — leads B2B. (1 crédito por página)
API de leads de pessoas — Contatos por região, sem CPF e sem repetição, a partir do Scale. (1 crédito a cada 10 contatos, a partir do Scale)
API de advogados (OAB) — Ficha do advogado pela OAB e busca por nome. (1 crédito por ficha)
API do DJEN (publicações e prazos) — Publicações por OAB, parte ou processo, monitores e prazos. (1 crédito por página de busca)
API de licitações (editais abertos) — Editais abertos, itens, análise por IA e alertas. (1 crédito por página)
API de imóveis (cadastro municipal) — Ficha do lote do cadastro da prefeitura — 7 cidades. (5 créditos por ficha, a partir do Builder)
Webhooks — Eventos assinados com HMAC: intimação, edital, empresa nova. (Sem custo por entrega)

Todas as APIs e os planos