ForgeMesh x402 Ads

Recomendaciones de anuncios x402, análisis de intención e informes de demanda de comercio automático.

Documentación

@forgemeshlabs/x402-ads-mcp

Instala un middleware. Monetiza respuestas 402 no utilizadas con recomendaciones, descubrimiento y analítica de comercio automatizado.

Este es el lado MCP de esa red: lo que los agentes autónomos exploran, quieren y abandonan en el ecosistema x402 — como herramientas para tu agente.

Envuelve la Red de Anuncios e Intenciones ForgeMesh x402. Las herramientas de pago se liquidan por llamada en USDC en la red principal de Base a través del protocolo x402 — sin cuenta, sin clave API; tu billetera es el inicio de sesión. Los editores reciben informes sobre sus propios servicios gratis.

Instalación

{
  "mcpServers": {
    "intent": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-ads-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x... (optional — enables paid analytics)",
        "X402_ADS_PUBLISHER_KEY": "pub_... (optional — free reports on your own services)"
      }
    }
  }
}

Ambas variables de entorno son opcionales. Sin ninguna configurada, las herramientas gratuitas funcionan por completo y las de pago devuelven el desafío de pago x402 (precio, red, payTo) en lugar de liquidar — útil para inspeccionar antes de gastar algo.

Bonificación: registro de editor en un comando

Este paquete también funciona como CLI de registro para operadores de API (sin necesidad de cliente MCP):

# read the terms first: https://ads.forgemesh.io/terms
WALLET_PRIVATE_KEY=0xYOUR_WALLET npx -y @forgemeshlabs/x402-ads-mcp register \
  --url https://api.your-service.com --accept-terms

Un pago único de $0.10 USDC en Base; la billetera que paga se convierte en tu identidad y tu clave de editor se imprime una sola vez. Las solicitudes inválidas se rechazan antes del pago — no puedes pagar por un registro fallido.

Herramientas

Herramienta	Precio	Qué devuelve
`get_network_counters`	gratis	Totales de red en vivo: 402s observados, solicitudes de clase de agente, recomendaciones servidas
`preview_recommendations`	gratis	El bloque exacto de recomendaciones que el middleware inyecta en un 402
`get_terms`	gratis	Términos canónicos + divulgación completa de recopilación de datos
`get_network_stats`	$0.005	Totales de red + desglose de clasificación monitor/indexador/agente
`get_intent_trends`	$0.01	Principales endpoints y categorías que solicitan los agentes autónomos
`get_category_demand`	$0.02	Profundidad de demanda para una categoría: volumen, participación de compradores, puntos de precio
`get_intent_report`	$0.05 / gratis*	Embudo de por qué los agentes no compraron para un servicio

* get_intent_report es gratis con X402_ADS_PUBLISHER_KEY para servicios a los que contribuyes eventos — la regla del cooperativo de datos: tus propios datos son gratis, para siempre.

Entorno

Variable	Requerida	Propósito
`WALLET_PRIVATE_KEY`	no	Billetera de red principal de Base que contiene USDC; habilita la liquidación automática de herramientas de pago
`X402_ADS_PUBLISHER_KEY`	no	Clave de editor de ads.forgemesh.io; carril gratuito para tus propios informes
`X402_ADS_BASE_URL`	no	Sobrescribe la URL base de la red (por defecto `https://ads.forgemesh.io`)
`BASE_RPC_URL`	no	Sobrescribe el RPC de Base (por defecto `https://mainnet.base.org`)

Usa una billetera caliente dedicada que contenga solo pequeños saldos de trabajo. La clave nunca sale de tu máquina — los pagos se firman localmente (EIP-3009) y se liquidan en cadena.

Las configuraciones listas están en examples/: un bloque mcpServers de Claude Desktop y una plantilla comentada de variables de entorno.

Pruebas (seguras por diseño)

npm test                # smoke: MCP boots over stdio and lists its 7 tools
npm run test:free       # free tools against the live network
npm run test:challenge  # every paid tool returns an x402 challenge — no wallet, nothing can spend
npm run test:all        # all of the above

Ninguna prueba liquida un pago. La prueba de desafío elimina las variables de entorno de pago antes de cargar, por lo que no puede mover fondos incluso si tu shell tiene una billetera configurada.

La red en una frase

Medimos el comercio automatizado, no el contenido de API — los editores que ejecutan el middleware @forgemeshlabs/x402-ads contribuyen metadatos anonimizados de sondeo 402; este MCP vende la señal agregada de demanda de vuelta a agentes y desarrolladores.

Divulgación completa de lo que los editores envían (y nunca envían): https://ads.forgemesh.io/terms