CompanyProof

Encuentra empresas legales, recupera perfiles de registro y verifica datos de identidad empresarial admitidos con evidencia de fuente. MCP remoto con autenticación OAuth o clave API.

Ver en companyproof.aiPrueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Connecta CompanyProof a agentes de IA mediante Streamable HTTP MCP. Lee nombres de herramientas, opciones de OAuth y claves API, comportamiento de verificación y errores de uso.

URL BASE https://companyproof.ai/v2 JSON · Autenticación Bearer

Proporciona a los agentes herramientas tipadas de empresas de CompanyProof.

CompanyProof MCP utiliza Streamable HTTP sin estado. Conecta ChatGPT directamente a https://companyproof.ai/v2/mcp y completa el inicio de sesión OAuth de CompanyProof; no pegues una clave API en ChatGPT. Los clientes MCP personalizados pueden seguir enviando una clave API bearer de CompanyProof.

CompanyProof MCP

https://companyproof.ai/v2/mcp

Copia esta dirección en la configuración del servidor de tu cliente MCP. Abrirla en un navegador muestra esta guía de conexión.

ChatGPT se conecta con OAuth. El servidor expone herramientas de búsqueda de empresas y perfiles de solo lectura bajo company.read, además de la herramienta consecuente verify_company_claims bajo proof.write. Los clientes MCP personalizados pueden autenticar llamadas a herramientas con una clave API bearer de CompanyProof.

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

Esta configuración de clave API es para clientes MCP personalizados, no para ChatGPT, y no es sintaxis universal de cliente. Usa la función segura de sustitución de secretos del cliente para que ${COMPANYPROOF_API_KEY} se reemplace antes de enviar la solicitud; nunca envíes ese marcador de posición literalmente.

LEER search_companies

Entradas: identifier_type, identifier, country, opcional subdivision, city_or_state y limit. Los tipos de identificador incluyen name, registration_number, vat_tax_id y ticker. Devuelve la misma lista tipada de empresas que la búsqueda REST. OAuth requiere company.read; los clientes con clave API requieren acceso en vivo elegible. Cada llamada consume un crédito compartido.

LEER get_company_profile

Entrada: company_id. Devuelve el sobre de perfil de CompanyProof y la disponibilidad de secciones. OAuth requiere company.read; los clientes con clave API requieren acceso en vivo elegible. Cada llamada consume un crédito compartido.

ESCRIBIR verify_company_claims

Entradas: company, exactamente uno de answer o claims, opcional monitor y idempotency_key. OAuth requiere proof.write. Los clientes con clave API pueden usar claves de prueba o en vivo elegibles. La herramienta escribe una prueba y consume créditos de reclamación.

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 El descubrimiento es público. Usa la versión de protocolo actual 2026-07-28. Envía los encabezados coincidentes MCP-Protocol-Version y Mcp-Method más la versión de protocolo, identidad del cliente y capacidades en params._meta. El resultado identifica CompanyProof y sus versiones compatibles.
  2. 02 tools/list El listado de herramientas es público. Envía Mcp-Method: tools/list y los mismos metadatos de solicitud. El resultado JSON contiene orden determinista de herramientas, esquemas de entrada/salida en vivo, anotaciones, alcances OAuth requeridos y sugerencias de caché privadas.
  3. 03 tools/call Las llamadas a herramientas requieren alcances OAuth de CompanyProof o una clave API bearer. Envía Mcp-Method: tools/call y un Mcp-Name coincidente. Los resultados JSON exitosos devuelven structuredContent tipado más un respaldo de texto JSON.

Compatibilidad con clientes 2025

Los clientes que usan 2025-11-25 o 2025-06-18 siguen siendo compatibles mediante el flujo Streamable HTTP basado en inicialización: initialize, notifications/initialized, luego tools/list o tools/call. Las solicitudes heredadas posteriores a la inicialización incluyen el MCP-Protocol-Version negociado y reciben respuestas SSE. El servidor no tiene estado y no emite MCP-Session-Id.

Límite de errores MCP

El descubrimiento y el listado de herramientas no requieren credenciales. Las llamadas a herramientas requieren un token OAuth válido con el alcance de la herramienta o una clave API de CompanyProof; la autorización faltante, inválida o insuficiente devuelve un desafío de autenticación o un fallo sin ejecutar la herramienta. Una credencial en vivo válida en una cuenta con facturación suspendida devuelve HTTP 402 con billing_payment_required y sin desafío OAuth; restaura la facturación en lugar de reconectar, y la misma credencial se reanuda automáticamente. Un cuerpo MCP ilegible puede fallar antes del envío JSON-RPC con HTTP 400 invalid_request_body; un mensaje MCP de más de 128 KiB falla con HTTP 413 body_too_large. La limitación de red o cuenta puede fallar con HTTP 429 y Retry-After. Un intercambio MCP válido aún puede devolver result.isError: true. Las operaciones completadas de CompanyProof colocan el sobre de error REST en result.content[0].text, así que ramifica en error.code cuando ese texto se analiza como JSON. Los fallos de validación de argumentos del SDK pueden ser texto plano que comienza con Input validation error; trata el texto no analizable como diagnóstico, no como un contrato de código de error estable. Los resultados de operaciones completadas preservan el contexto REST disponible en result._meta: companyproof.ai/http-status es un 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 y companyproof.ai/usage-reset son cadenas de valor de encabezado y aparecen solo cuando existe el valor correspondiente. Mcp-Name se aplica a tools/call, no a tools/list. Las anotaciones de solo lectura describen efectos secundarios, no costo: la búsqueda y el perfil aún consumen un crédito compartido. Aplica la política de aprobación y presupuesto de tu cliente a cada herramienta, y requiere aprobación para verify_company_claims.

Política de compatibilidad beta

CompanyProof puede agregar campos opcionales y nuevas herramientas durante la beta. Los nombres de herramientas existentes y los campos requeridos no se eliminarán ni renombrarán sin una transición de versión documentada. Mantén las claves de clientes personalizados en el almacén de credenciales seguro del cliente, usa OAuth para ChatGPT y usa una clave de idempotencia para reintentar la verificación.

Abrir ejemplos de plataforma y el contrato de herramientas →