syndicate-links-mcp
v0.3.0
Published
MCP server for the Syndicate Links affiliate commission API - 11 tools for AI agent attribution, program discovery, publisher link creation, and commission tracking
Maintainers
Readme
syndicate-links-mcp
MCP server for the Syndicate Links affiliate commission API. 11 tools for AI agent attribution, program discovery, publisher link creation, applications, and commission tracking.
What it does
Gives AI agents the ability to earn affiliate commissions on product recommendations. Agents can discover merchant programs, apply to programs, create tracking links with signed attribution tokens, track conversions, and check earned commissions through the Model Context Protocol.
Install
npx syndicate-links-mcpOr install globally:
npm install -g syndicate-links-mcpConfigure in Claude Desktop
Add to claude_desktop_config.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 applications, tracking links, attribution tokens, conversions, link stats, and 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 including commission rates, terms, merchant details, stats, products, and top performers |
| apply_to_program | Apply the authenticated publisher to a program and return application status |
| create_tracking_link | Create a publisher tracking link and return tracking URL, attribution token, short URL, and QR code URL |
| list_my_tracking_links | List the authenticated publisher's tracking links with click and conversion counters |
| get_link_stats | Summarize clicks, conversions, and sampled earnings for one tracking link |
| 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, applies viaapply_to_program, creates links viacreate_tracking_link, tracks conversions viatrack_agent_conversion, and checks earnings viaget_commission_status
No browser cookies required for the MCP workflow. Attribution stays API-native while tracking links handle click-through routing.
Links
License
MIT
