# syndicate-links-mcp

MCP server for the [Syndicate Links](https://syndicatelinks.co) 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

1. Agent developer signs up as a publisher at [affiliate.syndicatelinks.co](https://affiliate.syndicatelinks.co)
2. Issues an agent-scoped API key (`aff_agent_` prefix)
3. Configures this MCP server with the key
4. 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.

## Links

- [Syndicate Links](https://syndicatelinks.co)
- [API Docs](https://syndicatelinks.co/docs)
- [Getting Started Guide](https://syndicatelinks.co/docs/getting-started)
- [npm package](https://www.npmjs.com/package/syndicate-links-mcp)

## License

MIT