io.github.cmcgrabby-hue/syndicate-links

Official

by cmcgrabby-hue · TypeScript

Commission infrastructure for AI commerce — program discovery, attribution, and settlement.

Commission infrastructure for AI commerce with program discovery, attribution, and settlement.

syndicate-links-mcp

MCP server for the Syndicate Links affiliate commission API — 7 tools for AI agent attribution, program discovery, and commission tracking.

What it does

Gives AI agents the ability to earn affiliate commissions on product recommendations. Agents can discover merchant programs, track conversions with signed attribution tokens, and check earned commissions — all through the Model Context Protocol.

Install

bash

npx syndicate-links-mcp

Or install globally:

bash

npm install -g syndicate-links-mcp

Configure in Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "syndicate-links": {
      "command": "npx",
      "args": ["syndicate-links-mcp"],
      "env": {
        "SYNDICATE_API_URL": "https://api.syndicatelinks.co",
        "SYNDICATE_AGENT_KEY": "aff_agent_your_key_here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`SYNDICATE_API_URL`	Yes	API base URL (`https://api.syndicatelinks.co`)
`SYNDICATE_AGENT_KEY`	For agent tools	Agent-scoped key (`aff_agent_` prefix) for tracking conversions and checking commissions
`SYNDICATE_MERCHANT_KEY`	For merchant tools	Merchant key (`mk_live_` prefix) for listing your own programs
`SYNDICATE_ADMIN_SECRET`	For admin tools	Admin secret for running payout cycles
`AGENT_TOKEN_SECRET`	For verification	Secret for verifying attribution tokens

Tools

Tool	Description
`search_programs`	Find affiliate programs by keyword
`get_program_details`	Get full program info — commission rates, terms, merchant details
`list_merchant_programs`	List your own merchant programs (merchant key required)
`track_agent_conversion`	Record a conversion with a signed attribution token
`verify_attribution_token`	Validate a `slat_v1_` token without submitting a conversion
`get_commission_status`	Check your agent's earned commission balance
`run_payout_cycle`	Trigger the global payout cycle (admin only)

How it works

Agent developer signs up as a publisher at affiliate.syndicatelinks.co
Issues an agent-scoped API key (aff_agent_ prefix)
Configures this MCP server with the key
Agent discovers programs via search_programs, tracks conversions via track_agent_conversion, and checks earnings via get_commission_status

No browser cookies. No tracking links. Attribution is API-native.

License

MIT

Install

Configuration

Environment variables

SYNDICATE_API_URLrequired

API base URL for Syndicate Links

SYNDICATE_AGENT_KEYsecret

Agent-scoped API key (aff_agent_ prefix) for tracking conversions and checking commissions

SYNDICATE_MERCHANT_KEYsecret

Merchant API key (mk_live_ prefix) for listing your own programs

claude_desktop_config.json

{
  "mcpServers": {
    "syndicate-links": {
      "command": "npx",
      "args": [
        "-y",
        "syndicate-links-mcp@0.2.2"
      ],
      "env": {
        "SYNDICATE_API_URL": "<YOUR_SYNDICATE_API_URL>",
        "SYNDICATE_AGENT_KEY": "<YOUR_SYNDICATE_AGENT_KEY>",
        "SYNDICATE_MERCHANT_KEY": "<YOUR_SYNDICATE_MERCHANT_KEY>"
      }
    }
  }
}