Saltar al contenido principal
El servidor MCP de ChainPatrol pone toda la API pública a disposición de los agentes de IA en forma de herramientas: verificación y búsqueda de Assets (activos digitales: URL, dirección, perfil, app, etc.), reportes, revisión de Proposals (propuestas para bloquear o permitir un asset), Suspected Threats (amenazas sospechosas detectadas automáticamente, todavía sin confirmar) y configuraciones de detección, Takedowns (solicitudes de baja de contenido fraudulento), amenazas, métricas, healthchecks (verificaciones de estado) y administración de la organización. Cada operación de la referencia de la API es una herramienta que el agente puede llamar, excepto Subir archivo adjunto: para adjuntar un archivo a un reporte, súbelo tú y pasa la URL devuelta en attachmentUrls. Hay dos formas de conectarse:
  • Alojado (Hosted): apunta tu cliente a una URL e inicia sesión desde tu navegador. No hay nada que instalar.
  • Local: ejecuta chainpatrol mcp desde la CLI en tu propio equipo.
Ambos exponen las mismas herramientas y aplican los mismos permisos que tu cuenta de ChainPatrol o tu clave de API.

Servidor alojado

El servidor usa OAuth. La primera vez que tu cliente se conecta, abre en tu navegador una página de inicio de sesión y consentimiento de ChainPatrol. Después de que la apruebes, el cliente guarda el token y se vuelve a conectar por su cuenta. Los clientes que admiten el registro dinámico de clientes (dynamic client registration) no necesitan nada más que la URL.
Luego ejecuta /mcp dentro de Claude Code y elige chainpatrol para iniciar sesión.

Usar una clave de API en su lugar

Para cuentas de servicio y agentes sin interfaz (headless) que no pueden completar un inicio de sesión en el navegador, envía una clave de API en el encabezado X-API-KEY:

Servidor local (CLI)

El servidor también viene incluido con la CLI de ChainPatrol, que se encarga del inicio de sesión por ti:
Apunta tu cliente MCP a ese comando. Para Claude Code:
O en cualquier cliente que acepte una configuración mcpServers:
Para usar una cuenta de servicio, define CHAINPATROL_API_KEY en lugar de ejecutar chainpatrol login.

Configuración

chainpatrol mcp --tools asset_check,asset_list hace lo mismo que CHAINPATROL_MCP_TOOLS para una sola ejecución, y prevalece cuando ambos están definidos. Reducir la lista de herramientas ahorra presupuesto de contexto, pero no es un control de acceso. La API aplica la autorización según la credencial en uso.

Qué expone el servidor

  • Tools (herramientas): una por cada operación de la API pública. La mayoría de las herramientas tienen alcance de una sola organización y no hay un valor predeterminado implícito, así que llama primero a user_orgs y pasa el slug de la organización de forma explícita.
  • Resources (recursos): las listas largas de valores, como chainpatrol://enums/asset_type, y guías que explican qué significa cada etiqueta de Proposal y cada motivo de rechazo.
  • Prompts: flujos de trabajo listos para usar que reciben el slug de una organización:

Prompts de ejemplo

Una vez conectado, pregunta en lenguaje natural:
  • “¿Está claim-airdrop-example.xyz en la Blocklist de ChainPatrol?”
  • “Ejecuta el healthcheck de la organización para acme.”
  • “¿Qué reportes de acme están esperando la revisión del cliente?”
  • “¿Cuántas amenazas encontramos para acme esta semana y de qué fuentes?”

Buscar en esta documentación desde un agente

Esta página cubre el servidor para los datos de ChainPatrol. El sitio de documentación también ofrece su propio servidor MCP de solo lectura en https://chainpatrol.com/docs/mcp, que permite a un agente buscar en esta documentación. Agrégalo junto al servidor de ChainPatrol si quieres que el agente consulte cómo funciona la API mientras la usa.