MCP x402 — Verificación web respaldada por evidencia para agentes de IA

Verifica un vendedor, producto, oferta, política o afirmación antes de que un agente actúe

Proporciona a un agente de IA una página HTTP(S) pública y de 1 a 10 condiciones concretas. La herramienta verificar_condicoes devuelve una decisión basada en evidencia para cada condición:

• confirmado — la página respalda claramente la condición.

• rejeitado — la página contradice claramente la condición.

• incerto — la evidencia disponible en la página es insuficiente.

Cada verificación incluye la URL de origen final, el título de la página, la marca de tiempo, la explicación condición por condición, evidencia citada cuando esté disponible, un verificationId único y un pageHash SHA-256.

Diseñado para

• Agentes de compra y aprovisionamiento de IA;

• verificación de vendedor, producto y oferta;

• diligencia debida previa a la compra;

• verificación de políticas y términos;

• automatización comercial que requiere evidencia antes de actuar.

Integración simple con x402

• Validación previa gratuita antes del pago.

• $0.05 USDC por verificación en Base mainnet.

• No se requiere cuenta ni suscripción.

• Disponible a través de MCP y HTTP.

• Comprador listo para ejecutar incluido en este repositorio.

• Validación de Coinbase x402 superada y descubrimiento de Bazaar habilitado.

Puntos finales en vivo

• MCP: https://mcp-x402-production.up.railway.app/mcp

• Verificación previa gratuita: POST https://mcp-x402-production.up.railway.app/preflight/verify-conditions

• Verificación de pago: POST https://mcp-x402-production.up.railway.app/verify-conditions

• Salud: GET https://mcp-x402-production.up.railway.app/health

El servicio también proporciona análisis de URL públicas de pago y consulta general de IA a través de analisar_url y consultar_ia.

Related MCP server: Pylon MCP Server

Servicio en vivo

• URL base: https://mcp-x402-production.up.railway.app

• Comprobación de salud: GET /health

• Punto final MCP: POST /mcp

• Análisis de URL de pago: POST /analyze

• Precio: $0.05 USDC por solicitud de pago

• Red: Base mainnet (eip155:8453)

Estado de producción

• Implementación de producción activa en Railway

• Flujo de pago x402 versión 2

• Pagos en Base mainnet (eip155:8453)

• Validación de Coinbase x402 superada

• Simulación aceptada con HTTP 402

• Metadatos de descubrimiento de Bazaar habilitados

• Índice de Coinbase activo

Herramientas MCP

Verificación de decisiones

verificar_condicoes — $0.05 USDC

Una herramienta de verificación de decisiones de pago para agentes.

Proporciónale una URL pública y una o más condiciones concretas. Devuelve una decisión basada únicamente en la evidencia extraída de esa página:

• confirmado — la página prueba claramente la condición.

• rejeitado — la página contradice claramente la condición.

• incerto — la página no proporciona suficiente evidencia.

Cada resultado incluye la URL de origen final, el título de la página, la marca de tiempo de verificación, la explicación condición por condición y una breve prueba citada cuando esté disponible.

Ejemplos de condiciones:

• “La página identifica al vendedor.”

• “El producto está disponible en Portugal.”

• “La página muestra un precio en euros.”

• “El documento afirma que el servicio admite x402.”

Esto está diseñado para agentes que necesitan una decisión basada en evidencia antes de tomar la siguiente acción.

Tecnología

• Node.js y TypeScript

• Express

• Model Context Protocol

• OpenAI Responses API

• pagos x402

• viem

• Cheerio

• Railway

Seguridad

• HTTPS proporcionado por Railway

• Cabeceras de seguridad de Helmet

• Límite de velocidad de 100 solicitudes por 15 minutos

• Registros de solicitudes estructurados con identificadores de solicitud únicos

• Validación de host y soporte de comprobación de salud de Railway

• Clave de API de OpenAI restringida con acceso solo a /v1/responses

• Archivos de entorno y secretos excluidos de Git

Variables de entorno

Servidor

Comprador local

Ejemplo de archivo local .env.test:

EVM_PRIVATE_KEY=your_private_key_here

Desarrollo local

Instala las dependencias:

npm install

Inicia el servidor de desarrollo:

npm run dev

Compila el proyecto:

npm run build

Inicia el servidor compilado:

npm start

Comprobación de salud

El punto final de salud es público y no requiere pago:

curl https://mcp-x402-production.up.railway.app/health

Comprador x402 listo para ejecutar

El repositorio incluye compradores listos para ejecutar para aplicaciones y agentes de IA. El comprador MCP se conecta al servicio en vivo, valida los requisitos de pago x402 contra USDC de Base mainnet y un pago máximo de $0.05, firma el pago, reintenta la misma llamada de herramienta e imprime el recibo de liquidación y el resultado.

Clona y prepara el comprador:

git clone https://github.com/Diogoup26/mcp-x402.git
cd mcp-x402
npm install

Crea un archivo local .env.test en la raíz del proyecto:

EVM_PRIVATE_KEY=0xYOUR_64_HEX_CHARACTER_PRIVATE_KEY

Nunca confirmes .env.test ni expongas la clave privada.

Compila el proyecto:

npm run build

Los siguientes comandos autorizan pagos x402 reales en Base mainnet:

• consultar_ia: $0.02 USDC

• analisar_url: $0.05 USDC

• verificar_condicoes: $0.05 USDC

Análisis de URL HTTP

npm run analyze -- "https://example.com" "Summarize this page."

Verificación de decisiones HTTP

npm run verify -- "https://example.com" "The page identifies the seller."

Análisis de URL MCP

npm run mcp:analyze -- "https://example.com" "Summarize this page."

Consulta de IA MCP

npm run mcp:consult -- "Reply only with: MCP OK"

Verificación de decisiones MCP

npm run mcp:verify -- "https://example.com" "The page identifies the seller."

Un pago MCP exitoso imprime:

• PAGAMENTO MCP: success

• el recibo de liquidación

• la respuesta de la herramienta

El comprador MCP nunca imprime la clave privada y rechaza cualquier pago que:

• no esté en Base mainnet;

• no use el contrato USDC de Base configurado;

• supere los $0.05 USDC.

Implementación

La rama main está conectada a Railway. Cada push exitoso desencadena una nueva implementación. Railway usa:

npm run build
npm start

La ruta de comprobación de salud de la implementación es /health.

Licencia

ISC