pathguard-mcp

Permite que los agentes de IA compatibles con MCP revisen transacciones de criptomonedas en busca de estafas y errores directamente en la conversación, usando PathGuard. Funciona con clientes MCP locales como Claude Desktop, Claude Code, Gemini CLI, Grok CLI, Cursor y Codex, además de despliegues remotos con Streamable HTTP para los conectores web de ChatGPT y Grok.

Disponible en todos los planes, incluido el plan Free. Esto solo llama a los mismos endpoints de API autenticados que el resto, por lo que se aplica la cuota de tu clave de API existente.

Install

pip install pathguard-mcp

(Aún no está publicado en PyPI; por ahora, instala directamente desde el código fuente: pip install -e . desde esta carpeta.)

Requiere mcp >= 2.0. Se construyó y probó contra el SDK MCP actual. Si estás en una versión anterior con la antigua API FastMCP, actualízala primero (pip install --upgrade mcp); de lo contrario, no funcionará.

Obtén una clave de API

Regístrate gratis en pathguard.cieltech.org/docs.html si no tienes una.

Configura clientes MCP locales

Instala este paquete donde se ejecute el cliente y proporciónale al servidor tu clave de API de PathGuard. Los ejemplos siguientes usan el comando pathguard-mcp instalado. Si no está en tu PATH, sustitúyelo por la ruta completa del ejecutable.

Claude Desktop

Añade esto a la configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop y Claude tendrá acceso automáticamente a las herramientas de PathGuard.

Claude Code

claude mcp add --transport stdio pathguard -- \
  pathguard-mcp

Define PATHGUARD_API_KEY en el entorno que inicia Claude Code. También puedes usar la configuración MCP de Claude Code para pasar esa variable explícitamente.

Gemini CLI

Añade esta entrada a ~/.gemini/settings.json para una configuración de ámbito de usuario, o a .gemini/settings.json dentro de un proyecto:

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

O añádela desde la línea de comandos después de exportar tu clave:

export PATHGUARD_API_KEY=pg_your_key_here
gemini mcp add --scope user pathguard pathguard-mcp

Grok CLI

Después de exportar tu clave, añade el servidor stdio local:

export PATHGUARD_API_KEY=pg_your_key_here
grok mcp add pathguard -- pathguard-mcp

Para guardar la configuración manualmente en ~/.grok/config.toml, usa:

[mcp_servers.pathguard]
command = "pathguard-mcp"
env = { PATHGUARD_API_KEY = "${PATHGUARD_API_KEY}" }

Codex, Cursor, VS Code y otros clientes MCP locles

Usa la misma definición de servidor stdio que en el ejemblo de Claude Desctop: comando pathguard-mcp, sin argugump los, y PATHGUARD_API_KEY en su entorno. La ubicación exacta del archvivo de configigracúon y la interfaz depar van seg ún alcl client; la configracón del serv al MCP es la misma.

Translate carefully please. I mistakenly introduced nonsense "GXP7### Codex..." Need start new header correctly.

Let's re-write section after GXP7:

Codex, Cursor, VS Code y otros clientes MCP locales

Usa la misma definición de servidor stdio que en el ejemplo de Claude Desktop: comando pathguard-mcp, sin argumentos, y PATHGUARD_API_KEY en su entorno. La ubicación exacta del archivo de configuración y la interfaz difieren según el cliente; la configuración del servidor MCP es la misma.

Ok.

Let's now assemble fully with correct.

I need be extremely careful to avoid any errors. Let's produce final answer.

Wait we include "Copie"? no.

pathguard-mcp

Permite que los agentes de IA compatibles con MCP revisen transacciones de criptomonedas en busca de estafas y errores directamente en la conversación, usando PathGuard. Funciona con clientes MCP locales como Claude Desktop, Claude Code, Gemini CLI, Grok CLI, Cursor y Codex, además de despliegues remotos con Streamable HTTP para los conectores web de ChatGPT y Grok.

Disponible en todos los planes, incluido el plan Free. Esto solo llama a los mismos endpoints de API autenticados que el resto de herramientas, por lo que se aplica cuota de tu clave de API existente.

Instalación

pip install pathguard-mcp

(Aún no está publicado en PyPI; por ahora, instala directamente desde el código fuente: pip install -e . desde esta carpeta.)

Requiere mcp >= 2.0. Se construyó y probó contra el SDK MCP actual. Si estás en una versión anterior con la antigua API FastMCP, actualízala primero (pip install --upgrade mcp); de lo contrario, no funcionará.

Obtén una clave de API

Regístrate gratis en pathguard.cieltech.org/docs.html si no tienes una.

Configura clientes MCP locales

Instala este paquete donde se ejecute el cliente y luego entrégale al servidor tu clave de API de PathGuard. Los ejemplos siguientes usan el comando pathguard-mcp instalado. Si no está en tu PATH, reemplázلو por la ruta completa del ejecutable.

Claude Desktop

Añade esto a la configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop y Claude tendrá automáticamente acceso a las herramientas de PathGuard.

Claude Code

claude mcp add --transport stdio pathguard -- \
  pathguard-mcp

Define PATHGUARD_API_KEY en el entorno que inicia Claude Code. También puedes usar la configuración MCP de Claude Code para pasar esa variable explícitamente.

Gemini CLI

Añade esta entrada a ~/.gemini/settings.json para una configuración de ámbito de usuario, o a .gemini/settings.json dentro de un proyecto:

{
  "mcpServers": {
    "pathguard": {
      "command": "pathguard-mcp",
      "env": {
        "PATHGUARD_API_KEY": "pg_your_key_here"
      }
    }
  }
}

O añádela desde la línea de comandos después de exportar tu clave:

export PATHGUARD_API_KEY=pg_your_key_here
gemini mcp add --scope user pathguard pathguard-mcp

Grok CLI

Después de exportar tu clave, añade el servidor stdio local:

export PATHGUARD_API_KEY=pg_your_key_here
grok mcp add pathguard -- pathguard-mcp

Para guardar la configuración manualmente en ~/.grok/config.toml, usa:

[mcp_servers.pathguard]
command = "pathguard-mcp"
env = { PATHGUARD_API_KEY = "${PATHGUARD_API_KEY}" }

Codex, Cursor, VS Code y otros clientes MCP locales

Usa la misma definición de servidor stdio que en el ejemplo de Claude Desktop: comando pathguard-mcp, sin argumentos, y PATHGUARD_API_KEY en su entorno. La ubicación exacta del archivo de configuración y la interfaz difieren según el cliente; la configuración del servidor MCP es la misma.

Configura clientes remotos: ChatGPT y Grok web

Los conectores personalizados basados en el navegador de ChatGPT y Grok no pueden ejecutar un comando en tu computadora. Despliega PathGuard MCP con Streamable HTTP, detrás de HTTPS, y luego introduce el endpoint público en la interfaz del conector.

export PATHGUARD_API_KEY=pg_your_key_here
pathguard-mcp --transport streamable-http --host 0.0.0.0 --port 8000 \
  --allowed-host mcp.example.com

El endpoint MCP es http://<host>:8000/mcp. Para ChatGPT o Grok web, publíLlo como una URL HTTPS protegida, como https://mcp.example.com/mcp; no expongas una clave de API en un navegador ni en un repositorio. Pasa su nombre de host con --allowed-host (o define PATHGUARD_MCP_ALLOWED_HOSTS=mcp.example.com) para que el servidor pueda aceptar de forma segura las solicitudes hechas a través de ese dominio público. La credencial de PathGuard de este servidor está en el servidor, por lo que cada instancia desplegada representa la cuenta de PathGuard asociada a su PATHGUARD_API_KEY.

ChatGPT

En un espacio de ChatGPT con el modo de desarrollador activado, crea una app MCP personalizada, ofrece el endpoint público https://.../mcp, explora sus herramientas y función la guarda o publica según convenga a tu espacio. ChatGPT solo se conecta a servidores MCP remotos, no a comandos stdio locales. Sobre la guía existente, consúltala la página Developer Mode y apps MCP de OpenAI para conocer la disponibilidad actual de planes y controles de configuración.

Grok web

En grok.com/connectors, selecciona Nuevo conector y luego Personalizado, e introducid the public https://.../mcp. Grok debe poder alcanzar el servidor a través de Internet Web visible. Consulte the custom experts de xAI para conectores MCP para seguir el flujo actual de conectores.

Notas de despliegue

• Usa Streamable HTTP para los despliegues remotos nuevos; es el transporte HTTP MCP actual.

• Termina TLS en tu plataforma de hosting o proxy renew, y restringe el acceso a usuarios de confianza o a una pasarela siempre que sea posible. El servidor actualmente se autentica ante PathGuard con una clave de API configurada; no autentica a usuarios individuales de MCP.

• Configura PATHGUARD_MCP_TRANSPORT=streamable-http, PATHGUARD_MCP_HOST=0.0.0.0, PATHGUARD_MCP_PORT=8000 y PATHGUARD_MCP_ALLOWED_HOSTS=mcp.example.com en lugar de los indicadores de línea de comandos si eso se adapta a tu plataforma de despliegue. PORT también se tiene en cuenta cuando PATHGUARD_MCP_PORT no está definido.

• Mantén el transporte stdio por defecto para los clientes de escritorio y de CLI.

Herramientas disponibles

Pruebas locales sin un despliegue real

Puedes usar un backend local en lugar de la producción:

export PATHGUARD_API_KEY=pg_your_test_key
export PATHGUARD_API_BASE=http://localhost:8000
pathguard-mcp

Referencia completa de la API

Consulta pathguard.cieltech.org/docs.html para ver documentación completa sobre endpoints, límites de tasa y el significado de los flags. Este servidor MCP es una delgada wrapper sobre esa misma API.