MCP-Pay

Una capa de monetización HTTP x402 sobre Algorand que permite a los agentes de IA pagar por herramientas MCP con un modelo de pago por llamada de menos de un centavo.

Problema

Los agentes de IA autónomos que usan el Model Context Protocol (MCP) no pueden acceder a herramientas de pago: las tarjetas de crédito, las claves API y las suscripciones son flujos de trabajo humanos. Los creadores de herramientas no tienen forma de cobrar por llamada, y las cadenas heredadas son demasiado lentas o caras para micropagos de máquina a máquina.

Related MCP server: Agent Commerce Gateway

Solución

MCP-Pay convierte cualquier herramienta MCP en un endpoint x402 monetizado al instante en Algorand.

1. Un agente descubre herramientas en GET /mcp/v1/tools (gratis, incluye esquemas JSON + precios).

2. El agente invoca POST /mcp/v1/tools/:name/execute sin pago.

3. El servidor responde 402 Payment Required con metadatos de pago (precio en USDC, dirección del receptor, red).

4. El middleware local del agente firma automáticamente una transferencia de USDC en Algorand (ASA 31566704) y reintenta.

5. El facilitador de GoPlausible verifica y liquida en cadena (finalidad <3.3s), la herramienta se ejecuta y los resultados regresan en un solo viaje de ida y vuelta.

Sin cuentas. Sin claves. Sin humanos.

Propuesta única de venta

Herramientas de pago incluidas

Arquitectura

┌────────────────────────┐
│   AI AGENT (client/)   │  1. GET /mcp/v1/tools      (discovery)
│  auto-paying MCP agent │  2. POST .../execute       → 402 challenge
└───────────┬────────────┘  3. sign USDC txn locally
            │               4. retry + X-PAYMENT header
            ▼
┌────────────────────────┐
│  MCP-PAY SERVER (Hono) │  x402 paymentMiddleware protects each tool route
│  registry + tools/*    │  executes tool only after verified settlement
└───────────┬────────────┘
            ▼
┌────────────────────────┐
│ GOPLAUSIBLE FACILITATOR│  /verify + /settle on Algorand TestNet
│  https://facilitator.  │  USDC (ASA 31566704) transfer
│  goplausible.xyz       │
└────────────────────────┘

Stack tecnológico

• TypeScript, Hono

• @x402/core, @x402/avm, @x402/hono, @x402/fetch

• @x402-avm/extensions (descubrimiento en Bazaar)

• Facilitador de GoPlausible, USDC de Algorand TestNet

Ejecutar en local

1. Requisitos previos

• Node.js 18+, pnpm (npm i -g pnpm)

• Dos cuentas de Algorand TestNet con fondos:

  • Monedero del servidor (receptor): solo la dirección

  • Monedero del agente (pagador): mnemónico, se mantiene local — nunca se hace commit

Fondea a través del grifo de Lora, haz opt-in de ambas cuentas a USDC en Lora y luego obtén USDC de TestNet desde el grifo de Circle (elige Algorand Testnet).

2. Configurar

pnpm install
cp .env.example .env

Rellena .env:

AVM_ADDRESS=<server wallet address>          # receiver
AVM_MNEMONIC="<agent 25-word mnemonic>"      # payer, LOCAL ONLY
SERVER_URL=http://localhost:4021

3. Iniciar el servidor y ejecutar el agente

pnpm server        # terminal 1
pnpm agent         # terminal 2: discovery → 402 → auto-pay → result

Verificar en cadena

Cada llamada exitosa liquida una transacción real de TestNet:

• Panel del facilitador: https://facilitator.goplausible.xyz/dashboard

• Explorador de Lora: https://lora.algokit.io/testnet

Ejemplo de TX de liquidación (de una ejecución de demostración):

TODO: paste Lora transaction link after first live run

API

Hoja de ruta

• Guardia de política de gasto: presupuestos por agente aplicados por el middleware

• Panel del creador: registra tu propia herramienta MCP + precio en minutos

• Listado en Bazaar en GoPlausible para que cualquier agente de terceros pueda descubrir las herramientas de MCP-Pay