Back to Browse

Api Examples MCP Server

Developer ToolsScan in ProgressMCP RegistryRemote
Free

Server data from the Official MCP Registry

Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.

About

Brazilian company and person data by CNPJ/CPF: registry, partners, tax status, sanctions, lawsuits.

Remote endpoints: streamable-http: https://app.dabradata.com/mcp

Security Report

0.0
Use Caution0.0Moderate Risk

10 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Remote servers are capped at 8.0 because source code is not available for review. The score reflects endpoint verification only.

What You'll Need

Set these up before or after installing:

DABRA_API_KEYRequired

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "com-dabradata-mcp": {
      "url": "https://app.dabradata.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Dabra - API Examples

License: MIT 133 consultas Docs

Exemplos de integracao com a API da Dabra: 133 consultas de dados brasileiros (CNPJ, CPF, KYC, compliance, processos judiciais, credito, sancoes internacionais) e envio de SMS/OTP, por uma API REST pre-paga, com uma unica chave.

Inicio rapido

  1. Crie a conta em app.dabradata.com/signup. Sem cartao de credito e sem mensalidade: voce paga por consulta, com saldo pre-pago.

  2. Na pagina de chaves do painel ha duas chaves:

    • teste (dabra_test_...): aceita qualquer valor com formato valido e devolve o exemplo de resposta do endpoint, a custo zero, marcado com o header X-Example: true. A validacao de parametros e a mesma da producao. Use para montar a integracao.
    • producao (dabra_live_...): consulta real, debitada do saldo.

    Chaves emitidas antes de 24/09/2026 (fd_live_..., fd_test_...) continuam validas.

  3. Rode um exemplo:

curl -H "X-API-Key: dabra_test_SUA_CHAVE" \
  "https://app.dabradata.com/api/v1/consulta/receita-federal-pj?cnpj=00000000000191"

Todos os exemplos leem a chave da variavel de ambiente DABRA_API_KEY:

export DABRA_API_KEY=dabra_test_SUA_CHAVE
python python/cnpj.py 00.000.000/0001-91

Formato das chamadas

GET https://app.dabradata.com/api/v1/consulta/<slug>?<parametro>=<valor>
X-API-Key: <sua chave>
  • Os parametros vao na querystring (?cpf=..., ?cnpj=..., ?nome=...). CPF e CNPJ aceitam com ou sem pontuacao.
  • Algumas consultas pedem "um de" (por exemplo cpf ou cnpj); a pagina de cada consulta diz quais parametros sao obrigatorios.
  • As listas internacionais (OFAC, ONU, UE, Reino Unido, FBI, Interpol) sao consultadas por nome. Para pessoa fisica com CPF, listas-restritivas cruza 17 listas nacionais e internacionais pelo documento.
  • Mensageria (sms-enviar, otp-send, otp-verify, otp-resend, sms-status) e mais algumas consultas usam POST com corpo JSON.
  • A resposta de sucesso e o JSON da consulta, sem envelope.
  • Para repetir uma chamada com seguranca, envie X-Idempotency-Key: a mesma chave devolve a resposta original sem cobrar de novo.

Referencia completa, com preco, parametros e exemplo de resposta de cada consulta: dabradata.com/docs. Toda pagina da referencia tambem existe em markdown, no mesmo endereco com .md no fim.

Exemplos por linguagem

LinguagemPastaDependenciasRodar
cURL (bash)/curlnenhuma./curl/cnpj.sh 00000000000191
Python/pythonpip install -r python/requirements.txtpython python/cnpj.py
Node.js/nodejsNode 18+, sem depsnode nodejs/cnpj.js
PHP/phpPHP 7.4+, ext-curlphp php/cnpj.php
Go/goGo 1.21+, stdlibgo run go/cnpj.go

Casos de uso

Custos de referencia pela tabela publica em 24/09/2026. O custo real de cada chamada vem no header X-Request-Cost; os precos atuais estao em dabradata.com/pricing.

CasoCustoPythonNode.jsPHPGocURL
Consultar CNPJ (Receita Federal + QSA)R$ 0,43cnpj.pycnpj.jscnpj.phpcnpj.gocnpj.sh
Consultar CPF (Receita Federal)R$ 0,54cpf.py---cpf.sh
KYC pessoa fisicaR$ 6,43 (Python) / R$ 6,00kyc_pf.pykyc_pf.jskyc_pf.phpkyc_pf.go-
KYC pessoa juridicaR$ 11,27kyc_pj.py----
Due diligence de empresaR$ 15,52due_diligence.py----
Background check de candidatoR$ 4,75background_check.py----
Compliance de fornecedores (CSV)R$ 2,59 por CNPJcompliance_fornecedor.py----
Sancoes internacionaisR$ 3,31 por nome----sancoes.sh
Enviar SMS e OTPR$ 0,29 por credito----sms.sh
Receber webhook (verificar assinatura)gratiswebhook_assinatura.py----

Headers de resposta

HeaderDescricao
X-Request-CostCusto debitado nesta chamada, em BRL
X-Balance-RemainingSaldo restante apos a chamada
X-RateLimit-Limit-RPM / X-RateLimit-Remaining-RPMLimite e restante por minuto
X-RateLimit-Limit-RPD / X-RateLimit-Remaining-RPDLimite e restante por dia
X-Response-Time-MsTempo de processamento
X-Exampletrue quando a resposta e o exemplo da chave de teste
X-Idempotent-Replaytrue quando a resposta veio de uma X-Idempotency-Key repetida

Erros

Todo erro tem o mesmo envelope:

{"error": {"code": "insufficient_balance", "message": "...", "hint": "...", "details": {}}}
HTTPcodeQuando
400invalid_parametersParametro ausente ou em formato invalido
401unauthorizedChave ausente ou invalida
402insufficient_balanceSaldo insuficiente; details traz required_brl e available_brl
403email_not_verified, kyc_requiredConta ainda nao liberada para consultar (e-mail ou verificacao pendente)
404not_foundSlug inexistente, ou documento sem registro na base consultada
429rate_limit_exceededLimite de requisicoes; respeite o header Retry-After
5xxvariaA fonte nao respondeu. Uma falha nunca significa "nada consta"

Em regra, erro nao e cobrado. Algumas fontes cobram mesmo quando nao ha registro para o documento; nesses casos o custo vem em X-Request-Cost, como numa resposta de sucesso.

Saldo

curl -H "X-API-Key: $DABRA_API_KEY" https://app.dabradata.com/api/v1/administrative/balance

Resposta com cache de 60 segundos; as respostas das consultas ja trazem o saldo no header X-Balance-Remaining. Ver dabradata.com/docs/administrativo/saldo.

Webhooks

Eventos disponiveis: sms.mo.received, sms.optout e topup.credited. Cada entrega e assinada com HMAC-SHA256 do corpo bruto no header X-Dabra-Signature: sha256=<hex>. Por compatibilidade, o mesmo valor tambem e enviado em X-FonteData-Signature durante 12 meses (a partir de 24/09/2026): valide o header novo e use o legado so como fallback. Retentativas por 24 horas; deduplique por event_id. Exemplo em python/webhook_assinatura.py e documentacao em dabradata.com/docs/webhooks.

MCP

As mesmas consultas estao disponiveis para Claude, ChatGPT, Cursor e outros clientes MCP, pelo servidor remoto:

https://app.dabradata.com/mcp

Login por OAuth 2.1 no navegador, sem colar chave. O preco e o saldo sao os mesmos da API REST, e toda execucao pede confirmacao do custo antes de debitar. Ver dabradata.com/docs/mcp.

Outros produtos

  • Lote: enriquecimento de uma planilha CSV inteira pelo painel, sem codigo. Formato dos arquivos: dabradata.com/docs/lote.
  • Dossie: relatorio de uma pessoa ou empresa por finalidade (credito, contratacao, due diligence), com parecer e fontes citadas: dabradata.com/dossie.
  • SMS e OTP: remetente white-label, OTP gerenciado e respostas do destinatario por webhook: dabradata.com/sms.

OpenAPI e Postman

No Postman, importe a colecao e preencha a variavel API_KEY. Com a chave de teste, cada requisicao devolve o exemplo do endpoint sem custo.

Links

Contribuindo

Veja CONTRIBUTING.md. Exemplos em novas linguagens sao bem-vindos.

Reviews

No reviews yet

Be the first to review this server!