CompanyProof

Encontre empresas legais, recupere perfis de registro e verifique fatos de identidade empresarial suportados com evidências de fonte. MCP remoto com autenticação OAuth ou chave de API.

Ver em companyproof.aiExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://companyproof.ai/v2/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Conecte o CompanyProof a agentes de IA via Streamable HTTP MCP. Leia nomes de ferramentas, opções de OAuth e chave de API, comportamento de verificação e erros de uso.

URL BASE https://companyproof.ai/v2 JSON · Autenticação Bearer

Dê aos agentes ferramentas tipadas de empresas do CompanyProof.

O CompanyProof MCP usa Streamable HTTP sem estado. Conecte o ChatGPT diretamente a https://companyproof.ai/v2/mcp e conclua o login OAuth do CompanyProof; não cole uma chave de API no ChatGPT. Clientes MCP personalizados podem continuar enviando uma chave de API Bearer do CompanyProof.

CompanyProof MCP

https://companyproof.ai/v2/mcp

Copie este endereço nas configurações de servidor do seu cliente MCP. Abri-lo em um navegador mostra este guia de conexão.

O ChatGPT conecta com OAuth. O servidor expõe ferramentas somente leitura de busca e perfil de empresas sob company.read, além da ferramenta consequente verify_company_claims sob proof.write. Clientes MCP personalizados podem autenticar chamadas de ferramentas com uma chave de API Bearer do CompanyProof.

{
  "mcpServers": {
    "companyproof": {
      "type": "http",
      "url": "https://companyproof.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${COMPANYPROOF_API_KEY}"
      }
    }
  }
}

Esta configuração de chave de API é para clientes MCP personalizados, não para o ChatGPT, e não é sintaxe universal de cliente. Use o recurso de substituição segura de segredos do cliente para que ${COMPANYPROOF_API_KEY} seja substituído antes do envio da solicitação; nunca envie esse espaço reservado literalmente.

LEITURA search_companies

Entradas: identifier_type, identifier, country, opcionais subdivision, city_or_state e limit. Os tipos de identificador incluem name, registration_number, vat_tax_id e ticker. Retorna a mesma lista tipada de empresas que a busca REST. OAuth exige company.read; clientes com chave de API exigem acesso ao vivo elegível. Cada chamada consome um crédito compartilhado.

LEITURA get_company_profile

Entrada: company_id. Retorna o envelope de perfil do CompanyProof e a disponibilidade de seções. OAuth exige company.read; clientes com chave de API exigem acesso ao vivo elegível. Cada chamada consome um crédito compartilhado.

ESCRITA verify_company_claims

Entradas: company, exatamente um de answer ou claims, opcionais monitor e idempotency_key. OAuth exige proof.write. Clientes com chave de API podem usar chaves de teste ou ao vivo elegíveis. A ferramenta escreve uma prova e consome créditos de reivindicação.

curl --request POST \
  --url https://companyproof.ai/v2/mcp \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --header "MCP-Protocol-Version: 2026-07-28" \
  --header "Mcp-Method: server/discover" \
  --data '{
    "jsonrpc": "2.0",
    "id": "discover",
    "method": "server/discover",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": { "name": "companyproof-client", "version": "1.0.0" },
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

curl --request POST \
  --url https://companyproof.ai/v2/mcp \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --header "MCP-Protocol-Version: 2026-07-28" \
  --header "Mcp-Method: tools/list" \
  --data '{
    "jsonrpc": "2.0",
    "id": "tools",
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": { "name": "companyproof-client", "version": "1.0.0" },
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

curl --request POST \
  --url https://companyproof.ai/v2/mcp \
  --header "Authorization: Bearer $COMPANYPROOF_TEST_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --header "MCP-Protocol-Version: 2026-07-28" \
  --header "Mcp-Method: tools/call" \
  --header "Mcp-Name: verify_company_claims" \
  --data '{
    "jsonrpc": "2.0",
    "id": "verify",
    "method": "tools/call",
    "params": {
      "name": "verify_company_claims",
      "arguments": {
        "company": {
          "name": "CompanyProof Sandbox Limited",
          "country": "GB",
          "registration_number": "CP000001"
        },
        "claims": [
          { "field": "status", "published": "Active" }
        ],
        "monitor": false,
        "idempotency_key": "verify_agent_01J62E8A"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": { "name": "companyproof-client", "version": "1.0.0" },
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'
  1. 01 server/discover A descoberta é pública. Use a versão atual do protocolo 2026-07-28. Envie os cabeçalhos correspondentes MCP-Protocol-Version e Mcp-Method além da versão do protocolo, identidade do cliente e capacidades em params._meta. O resultado identifica CompanyProof e suas versões suportadas.
  2. 02 tools/list A listagem de ferramentas é pública. Envie Mcp-Method: tools/list e os mesmos metadados de solicitação. O resultado JSON contém ordem determinística de ferramentas, esquemas de entrada/saída ao vivo, anotações, escopos OAuth exigidos e dicas privadas de cache.
  3. 03 tools/call Chamadas de ferramentas exigem escopos OAuth do CompanyProof ou uma chave de API Bearer. Envie Mcp-Method: tools/call e um Mcp-Name correspondente. Resultados JSON bem-sucedidos retornam structuredContent tipados além de um fallback de texto JSON.

Compatibilidade com clientes 2025

Clientes que usam 2025-11-25 ou 2025-06-18 permanecem suportados pelo fluxo Streamable HTTP baseado em inicialização: initialize, notifications/initialized, depois tools/list ou tools/call. Solicitações legadas pós-inicialização incluem o MCP-Protocol-Version negociado e recebem respostas SSE. O servidor não tem estado e não emite MCP-Session-Id.

Limite de erros MCP

Descoberta e listagem de ferramentas não exigem credenciais. Chamadas de ferramentas exigem um token OAuth válido com o escopo da ferramenta ou uma chave de API do CompanyProof; autorização ausente, inválida ou insuficiente retorna um desafio de autenticação ou falha sem executar a ferramenta. Uma credencial ao vivo válida em uma conta com cobrança suspensa retorna HTTP 402 com billing_payment_required e sem desafio OAuth; restaure a cobrança em vez de reconectar, e a mesma credencial retoma automaticamente. Um corpo MCP ilegível pode falhar antes do despacho JSON-RPC com HTTP 400 invalid_request_body; uma mensagem MCP acima de 128 KiB falha com HTTP 413 body_too_large. Limitação de rede ou conta pode falhar com HTTP 429 e Retry-After. Uma troca MCP válida ainda pode retornar result.isError: true. Operações concluídas do CompanyProof colocam o envelope de erro REST em result.content[0].text, então ramifique em error.code quando esse texto for analisado como JSON. Falhas de validação de argumentos do SDK podem, em vez disso, ser texto simples começando com Input validation error; trate texto não analisável como diagnóstico, não como um contrato estável de código de erro. Resultados de operações concluídas preservam o contexto REST disponível em result._meta: companyproof.ai/http-status é um número; companyproof.ai/retry-after, companyproof.ai/rate-limit, companyproof.ai/rate-remaining, companyproof.ai/rate-reset, companyproof.ai/usage-limit, companyproof.ai/usage-remaining e companyproof.ai/usage-reset são strings de valores de cabeçalho e aparecem apenas quando o valor correspondente existe. Mcp-Name aplica-se a tools/call, não a tools/list. Anotações somente leitura descrevem efeitos colaterais, não custo: busca e perfil ainda consomem um crédito compartilhado. Aplique a política de aprovação e orçamento do seu cliente a cada ferramenta e exija aprovação para verify_company_claims.

Política de compatibilidade beta

O CompanyProof pode adicionar campos opcionais e novas ferramentas durante o beta. Nomes de ferramentas existentes e campos obrigatórios não serão removidos ou renomeados sem uma transição de versão documentada. Mantenha chaves de clientes personalizados no armazenamento seguro de credenciais do cliente, use OAuth para o ChatGPT e use uma chave de idempotência para repetir a verificação.

Abra exemplos de plataforma e o contrato de ferramentas →