ForgeMesh Affiliate Router

Enruta pagos x402, divisiones de afiliados Pyrimid y enlaces de referencia a través de adaptadores neutrales al proveedor.

GitHub

Documentación

affiliate-router-mcp

Enrutamiento de monetización neutral respecto al proveedor para herramientas de agentes. Un servidor MCP que descubre, enruta y atribuye ingresos a través de APIs de pago, enlaces de referencia y programas de afiliados.

Fuente: https://github.com/forgemeshlabs/affiliate-router-mcp

El enrutador no está vinculado a ninguna red de pago o sistema de afiliados en particular. Los adaptadores son conectables. El registro es un archivo JSON local que tú controlas.

Estado: experimental · v0.1.10

Aviso: Este MCP no garantiza pagos. Enruta datos de atribución según las reglas de cada proveedor/programa. La distribución de comisiones es aplicada por el sistema de pago del proveedor, no por este enrutador.

Qué hace

Los agentes necesitan una forma de llamar herramientas monetizables sin codificar cada sistema de afiliados o de pago. affiliate-router-mcp proporciona:

Descubrimiento — encuentra proveedores y productos por categoría o intención
Enrutamiento — elige automáticamente la ruta de pago/atribución correcta
Llamada — ejecuta pagos con atribución de afiliados
Generación de enlaces — inyecta parámetros de seguimiento en URLs de referencia
Telemetría — registra cada llamada atribuida localmente para seguimiento

8 Herramientas

Herramienta	Costo	Descripción
`search_opportunities`	Gratis	Encuentra productos por categoría o palabra clave
`list_affiliate_programs`	Gratis	Lista todos los proveedores y sus programas
`get_opportunity_details`	Gratis	Detalles completos de un proveedor/producto específico
`get_best_route`	Gratis	Recomienda la mejor ruta para una intención
`generate_affiliate_link`	Gratis	Construye una URL de referencia con seguimiento
`call_affiliate_product`	varía	Paga y llama un producto con atribución
`estimate_commission`	Gratis	Proyecta ganancias mensuales a un volumen de llamadas
`get_affiliate_telemetry`	Gratis	Ve el registro de atribución local

Adaptadores

Cada sistema de pago o atribución es un adaptador separado. Agregar uno nuevo no afecta a los adaptadores existentes.

Adaptador	Cómo funciona	Pago	Estado
`x402_pyrimid`	Aprueba USDC → `routePayment` en cadena → reintenta con hash de transacción	División de USDC en cadena	Probado
`x402_direct`	EIP-3009 `transferWithAuthorization` vía facilitador de Coinbase	USDC en cadena al proveedor	Implementado
`referral_link` / `query_param_link`	Inyecta parámetro de afiliado en la URL; admite `optional_params` (p. ej., un VIN) y un modo `fixed_link` para URLs previamente rastreadas que no deben modificarse	Ninguno — depende del programa	Implementado
`awin_link`	Envuelve el `destination_url` de un producto detrás de la redirección `cread.php` de Awin con el `awinmid`/`awinaffid` del proveedor	Ninguno — depende del programa	Implementado

Pyrimid es el primer adaptador de afiliados de pago completamente probado. No es el único modelo compatible. Los adaptadores futuros pueden incluir: PartnerStack, Rewardful, Impact, Commission Junction, inyección de códigos de cupón/promo, programas de socios con clave API y otros protocolos emergentes de comercio para agentes.

Instalación

npm install -g affiliate-router-mcp

O con Claude Code / cualquier cliente MCP:

{
  "mcpServers": {
    "affiliate-router": {
      "command": "affiliate-router-mcp",
      "env": {
        "WALLET_PRIVATE_KEY": "0x...",
        "PYRIMID_AFFILIATE_ID": "af_your_id",
        "GUMROAD_AFFILIATE_ID": "your-gumroad-id"
      }
    }
  }
}

Variables de Entorno

Variable	Requerida	Notas
`WALLET_PRIVATE_KEY`	Para `call_affiliate_product` con adaptadores x402	Billetera base con USDC + ETH para gas
`PYRIMID_AFFILIATE_ID`	No	ID de afiliado predeterminado para productos registrados en Pyrimid
`GUMROAD_AFFILIATE_ID`	No	ID de seguimiento de Gumroad
`PARTNERSTACK_CODE`	No	Código de referencia de PartnerStack

Proveedores Incluidos

CoinOpAI (x402_pyrimid) — API de inteligencia criptográfica en Base mainnet

Kronos Signals — $0.05/llamada, 20% de comisión
Kronos Decision — $0.15/llamada, 20% de comisión
Trade Preflight — $0.05/llamada, 20% de comisión
Trade Audit — $0.07/llamada, 20% de comisión
Image Generation — $0.10/llamada, 20% de comisión

Gumroad (referral_link) — mercado de productos digitales, ~30% de comisión por producto

PartnerStack (referral_link) — programas de afiliados SaaS

ElevenLabs — voz/TTS con IA, 22% de los pagos durante 12 meses (fixed_link, sin parámetros adicionales)

Ledger (referral_link, fixed_link) — billeteras de hardware, 10% de comisión

Nano X, Nano S Plus, Stax — enlaces profundos por producto con seguimiento integrado

DigitalOcean (awin_link) — hosting en la nube, 10% de comisión recurrente durante 12 meses, cookie de 30 días

Página de inicio, precios de Droplets — envueltos detrás del cread.php de Awin

Amazon Influencer Storefront (referral_link, fixed_link) — tienda ai_tinkers, tarifas estándar de Associates, sin etiquetado por producto

ForgeMesh Vehicle History Reports (referral_link) — redirecciones rastreadas forgemesh.io/go, 25% por venta

EpicVIN, Detailed Vehicle History — pasa extra_params: {vin: "..."} a generate_affiliate_link para prellenar el VIN

Lógica de Enrutamiento

call_affiliate_product(vendor_id, product_id, params, affiliate_id?)
    ↓
resolve affiliate_id: tool arg → env var → null
    ↓
adapter = vendor.affiliate_system
    ↓
x402_pyrimid + affiliate_id present?
  cache VALID   → Pyrimid split flow (affiliate earns commission)
  cache INVALID → x402_direct fallback (vendor gets 100%)
  cache UNKNOWN → try Pyrimid → cache result → fallback on failure

x402_direct → EIP-3009 payment, no affiliate split
referral_link → inject tracking param, no payment

Actualizaciones de Paquete vs. Producto

Estas son preocupaciones independientes.

Actualizaciones de paquete (este repositorio):

Agregar o corregir adaptadores
Actualizar esquemas de herramientas
Cambiar la lógica de enrutamiento o caché
Actualizaciones de dependencias

Actualizaciones de producto/catálogo (registry.json):

Registrar nuevos endpoints de proveedores
Cambiar precios o tasas de comisión
Habilitar elegibilidad de afiliados en un producto
Asignar IDs de producto específicos de la red (p. ej., IDs de producto de Pyrimid)

Agregar un proveedor a registry.json no requiere un lanzamiento de paquete. Lanzar una nueva versión del paquete no requiere que los productos se vuelvan a registrar.

Agregar un Proveedor

Edita registry.json. No se necesitan cambios de código para proveedores de enlaces de referencia. Los proveedores x402 requieren una billetera financiada. Los proveedores de Pyrimid además requieren registro en cadena para obtener un vendor_id y pyrimid_product_id por producto.

{
  "id": "my_vendor",
  "name": "My Vendor",
  "affiliate_system": "referral_link",
  "affiliate_config": {
    "tracking_param": "ref",
    "affiliate_id_env": "MY_VENDOR_REF_CODE",
    "commission_pct": 25
  },
  "products": [...]
}

Telemetría

Todas las llamadas call_affiliate_product se agregan a logs/affiliate-telemetry.jsonl:

{
  "ts": "2026-05-14T17:07:01Z",
  "vendor_id": "coinopai",
  "product_id": "kronos_signals",
  "amount_usd": 0.05,
  "affiliate_id": "af_your_id",
  "payment_type": "x402_pyrimid",
  "commission_est_usd": 0.0099,
  "status": "success",
  "tx_hash": "0x..."
}

Lo que no está en v0

Sincronización remota de registros
Integraciones de API de PartnerStack / Impact.com / Rewardful
Panel web
Comisiones multinivel
Seguimiento de redirecciones del lado del servidor para enlaces

Parte del Ecosistema ForgeMesh

Infraestructura para ecosistemas de agentes monetizados.

Paquete	Qué es	Instalación
affiliate-router-mcp	Enrutamiento de monetización neutral respecto al proveedor (este paquete)	`npm i affiliate-router-mcp`
coinopai-mcp	Inteligencia criptográfica de pago vía x402	`npm i coinopai-mcp`
forgemesh-imagegen	MCP de generación de imágenes de pago	`npm i forgemesh-imagegen`

Cada paquete funciona de forma independiente. No se requiere dependencia compartida.

Licencia

MIT — CoinOpAI