Razão Social MCP Server (I.A.)

Integração nativa no protocolo Model Context Protocol (MCP) para assistentes e LLMs

Protocolo MCP JSON-RPC 2.0 Protegido por Rate Limit
Endpoint de Conexão Rápida

Conecte sua Inteligência Artificial ao Razão Social

Disponibilizamos um servidor MCP público para que modelos como Claude, Gemini, ChatGPT, Cursor IDE e Antigravity possam consultar dados cadastrais de empresas brasileiras, buscar CNPJs e verificar FAQs em tempo real.

POST https://www.razao.social/api/mcp

Como Configurar no seu Assistente (Cursor, Claude, Antigravity)

mcp_config.json Configuração Standard MCP 
{
  "mcpServers": {
    "razao-social": {
      "serverUrl": "https://www.razao.social/api/mcp",
      "headers": {
        "X-MCP-API-Key": "SUA_CHAVE_OPCIONAL"
      }
    }
  }
}

Ferramentas Disponíveis (MCP Tools)

Catálogo de funções expostas para execução por agentes e LLMs

5 Tools Ativas
1

consultar_cnpj_gratuito

Versão FREE

Consulta dados cadastrais oficiais da empresa pelo CNPJ de 14 dígitos. Retorna Razão Social, Nome Fantasia, CNAEs, Endereço, Sócios e Situação Cadastral com dados sensíveis (PII) mascarados conforme LGPD.

Parâmetros: • cnpj (string, obrigatório): 14 dígitos numéricos
2

buscar_empresas

Busca Textual

Pesquisa empresas registradas no índice oficial por nome, razão social, cidade ou prefixo de CNPJ, retornando os resultados correspondentes.

Parâmetros: • query (string, obrigatório): Termo de busca
• limite (int, opcional): Quantidade de resultados (máx 50)
3

obter_faq

Context Enrichment

Permite ao modelo de I.A. consultar a base de perguntas frequentes do Razão Social, com respostas oficiais sobre a origem dos dados (Receita Federal), direitos LGPD e regras de opt-out.

Parâmetros: • categoria (string, opcional): Categoria do FAQ (ex: geral, lgpd, empresas)
4

solicitar_optout_ocultacao

LGPD Opt-Out

Submete uma solicitação de remoção/ocultação de dados pessoais vinculados a uma empresa. Realiza cruzamento automático de titularidade por CPF e Nome com a Receita Federal.

Parâmetros: cnpj, nome_solicitante, cpf_solicitante, email_solicitante, vinculo, motivo
Valores permitidos para vinculo:
• "Sócio / Titular" (Sócio / Titular Atual)
• "Ex-Sócio / Ex-Administrador" (Ex-Sócio / Ex-Administrador)
• "Representante Legal" (Representante Legal / Procurador)
• "Outro" (Outro Vínculo Direto)
5

consultar_dados_validados

Acesso Autorizado

Permite a solicitação de dados completos desofuscados mediante fornecimento de comprovação de titularidade do sócio/titular (CPF completo) ou chave de API autorizada.

Parâmetros: • cnpj (string, obrigatório), cpf_titular (string, opcional), api_key (string, opcional)

Políticas de Controle de Taxa (Rate Limit) & Segurança

Acesso Anônimo (por IP)

Permite até 30 requisições por minuto por endereço de IP. Adequado para consultas pontuais e agentes locais de I.A.

Acesso Autenticado (API Key)

Permite até 120 requisições por minuto fornecendo o cabeçalho X-MCP-API-Key em cada chamada.