ForgeMesh Affiliate Router

affiliate-router-mcp

Roteamento de monetização neutro em relação a fornecedores para ferramentas de agentes. Um servidor MCP que descobre, roteia e atribui receita entre APIs pagas, links de referência e programas de afiliados.

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

O roteador não está vinculado a nenhuma rede de pagamento ou sistema de afiliados específico. Os adaptadores são plugáveis. O registro é um arquivo JSON local que você controla.

Status: experimental · v0.1.10

Aviso: Este MCP não garante pagamentos. Ele roteia dados de atribuição de acordo com as regras de cada fornecedor/programa. A distribuição de comissões é aplicada pelo sistema de pagamento do fornecedor, não por este roteador.

---

O que ele faz

Os agentes precisam de uma forma de chamar ferramentas monetizáveis sem codificar manualmente cada sistema de afiliados ou de pagamento. O affiliate-router-mcp fornece:

• Descoberta — encontre fornecedores e produtos por categoria ou intenção
• Roteamento — escolha automaticamente o caminho de pagamento/atribuição correto
• Chamada — execute pagamentos com atribuição de afiliados
• Geração de links — injete parâmetros de rastreamento em URLs de referência
• Telemetria — registre localmente cada chamada atribuída para rastreamento

---

8 Ferramentas

Ferramenta	Custo	Descrição
search_opportunities	Grátis	Encontre produtos por categoria ou palavra-chave
list_affiliate_programs	Grátis	Liste todos os fornecedores e seus programas
get_opportunity_details	Grátis	Detalhes completos sobre um fornecedor/produto específico
get_best_route	Grátis	Recomende a melhor rota para uma intenção
generate_affiliate_link	Grátis	Construa uma URL de referência rastreada
call_affiliate_product	varia	Pague e chame um produto com atribuição
estimate_commission	Grátis	Projete ganhos mensais em um volume de chamadas
get_affiliate_telemetry	Grátis	Veja o registro de atribuição local

---

Adaptadores

Cada sistema de pagamento ou atribuição é um adaptador separado. Adicionar um novo não afeta os adaptadores existentes.

Adaptador	Como funciona	Pagamento	Status
x402_pyrimid	Aprovar USDC → routePayment on-chain → tentar novamente com hash de transação	Divisão de USDC on-chain	Testado
x402_direct	EIP-3009 transferWithAuthorization via facilitador da Coinbase	USDC on-chain para o fornecedor	Implementado
referral_link / query_param_link	Injetar parâmetro de afiliado na URL; suporta optional_params (ex.: um VIN) e um modo fixed_link para URLs pré-rastreadas que não devem ser modificadas	Nenhum — depende do programa	Implementado
awin_link	Envolve o destination_url de um produto atrás do redirecionamento cread.php da Awin com o awinmid/awinaffid do fornecedor	Nenhum — depende do programa	Implementado

Pyrimid é o primeiro adaptador de afiliados pago totalmente testado. Não é o único modelo suportado. Adaptadores futuros podem incluir: PartnerStack, Rewardful, Impact, Commission Junction, injeção de códigos de cupom/promoção, programas de parceiros com chave de API e outros protocolos emergentes de comércio para agentes.

---

Instalação

npm install -g affiliate-router-mcp

Ou com Claude Code / qualquer 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"
      }
    }
  }
}

---

Variáveis de Ambiente

Variável	Obrigatória	Observações
WALLET_PRIVATE_KEY	Para call_affiliate_product com adaptadores x402	Carteira base com USDC + ETH para gás
PYRIMID_AFFILIATE_ID	Não	ID de afiliado padrão para produtos registrados na Pyrimid
GUMROAD_AFFILIATE_ID	Não	ID de rastreamento do Gumroad
PARTNERSTACK_CODE	Não	Código de referência do PartnerStack

---

Fornecedores Incluídos

CoinOpAI (x402_pyrimid) — API de inteligência cripto na mainnet da Base

• Kronos Signals — $0,05/chamada, 20% de comissão
• Kronos Decision — $0,15/chamada, 20% de comissão
• Trade Preflight — $0,05/chamada, 20% de comissão
• Trade Audit — $0,07/chamada, 20% de comissão
• Image Generation — $0,10/chamada, 20% de comissão

Gumroad (referral_link) — marketplace de produtos digitais, ~30% de comissão por produto

PartnerStack (referral_link) — programas de afiliados SaaS

• ElevenLabs — voz/TTS com IA, 22% dos pagamentos por 12 meses (fixed_link, sem parâmetros extras)

Ledger (referral_link, fixed_link) — carteiras de hardware, 10% de comissão

• Nano X, Nano S Plus, Stax — deep links por produto com rastreamento embutido

DigitalOcean (awin_link) — hospedagem em nuvem, 10% de comissão recorrente por 12 meses, cookie de 30 dias

• Página inicial, preços de Droplets — envolvidos atrás do cread.php da Awin

Amazon Influencer Storefront (referral_link, fixed_link) — vitrine ai_tinkers, taxas padrão da Associates, sem marcação por produto

ForgeMesh Vehicle History Reports (referral_link) — redirecionamentos rastreados forgemesh.io/go, 25% por venda

• EpicVIN, Detailed Vehicle History — passe extra_params: {vin: "..."} para generate_affiliate_link para pré-preencher o VIN

---

Lógica de Roteamento

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

---

Atualizações de Pacote vs. Atualizações de Produto

São preocupações independentes.

Atualizações de pacote (este repositório):

• Adicionar ou corrigir adaptadores
• Atualizar esquemas de ferramentas
• Alterar a lógica de roteamento ou cache
• Atualizações de dependências

Atualizações de produto/catálogo (registry.json):

• Registrar novos endpoints de fornecedores
• Alterar preços ou taxas de comissão
• Habilitar elegibilidade de afiliados em um produto
• Atribuir IDs de produto específicos da rede (ex.: IDs de produto da Pyrimid)

Adicionar um fornecedor ao registry.json não exige uma versão do pacote. Lançar uma nova versão do pacote não exige que os produtos sejam re-registrados.

---

Adicionando um Fornecedor

Edite o registry.json. Nenhuma alteração de código é necessária para fornecedores de links de referência. Fornecedores x402 exigem uma carteira financiada. Fornecedores Pyrimid exigem adicionalmente registro on-chain para obter um vendor_id e pyrimid_product_id por produto.

{
  "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": [...]
}

---

Telemetria

Todas as chamadas call_affiliate_product são anexadas ao 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..."
}

---

O que não está na v0

• Sincronização remota de registro
• Integrações de API do PartnerStack / Impact.com / Rewardful
• Painel web
• Comissões multinível
• Rastreamento de redirecionamento no servidor para links

---

Parte do Ecossistema ForgeMesh

Infraestrutura para ecossistemas de agentes monetizados.

Pacote	O quê	Instalação
affiliate-router-mcp	Roteamento de monetização neutro em relação a fornecedores (este pacote)	npm i affiliate-router-mcp
coinopai-mcp	Inteligência cripto paga via x402	npm i coinopai-mcp
forgemesh-imagegen	MCP de geração de imagens pago	npm i forgemesh-imagegen

Cada pacote funciona de forma independente. Nenhuma dependência compartilhada é necessária.

---

Licença

MIT — CoinOpAI