MCP Server Integration for Agent Attribution
The Model Context Protocol (MCP) is the standard interface for AI agents to interact with external tools and services. Syndicate Links provides an MCP server that exposes attribution and commission operations as native tools — allowing any MCP-compatible agent to track referrals, verify attribution, check commission status, and trigger payouts without writing custom API integration code.
Installation
The Syndicate Links MCP server is available via npm and can be used with Claude Desktop, Cursor, or any MCP-compatible agent runtime:
npx syndicate-links-mcp
Or install globally:
npm install -g syndicate-links-mcp
Claude Desktop Configuration
Add to your Claude Desktop MCP configuration (claude_desktop_config.json):
{
"mcpServers": {
"syndicate-links": {
"command": "npx",
"args": ["syndicate-links-mcp"],
"env": {
"SL_API_KEY": "aff_agent_your_key_here"
}
}
}
}
Available Tools
The MCP server exposes seven tools for attribution and publisher operations:
track_referral
Record an attribution event when the agent makes a recommendation.
Input:
merchant_id(string) — the merchant being recommendedproduct_id(string, optional) — specific product or servicemetadata(object, optional) — additional context about the recommendation
Output: A signed SLAT token and attribution event ID.
verify_attribution
Check whether a specific attribution token is valid and has been matched to a conversion.
Input:
slat_token(string) — the SLAT token to verify
Output: Validation result including match status, conversion details, and commission amount if matched.
commission_status
Query the current commission balance and recent commission events.
Input:
status(string, optional) — filter by status:pending,approved,paidlimit(number, optional) — number of results to return
Output: Commission summary and itemized list.
run_payout_cycle
Trigger a payout for accumulated approved commissions.
Input:
method(string) — payout method:stripe,usdc,lightningamount(number, optional) — specific amount to pay out, or omit for full balance
Output: Payout confirmation with transaction reference.
list_merchant_programs
Browse available merchant programs that the agent can join and earn commissions from.
Input:
category(string, optional) — filter by merchant categorysort(string, optional) — sort bycommission_rate,popularity,newest
Output: List of merchant programs with commission terms.
get_attribution_report
Generate an attribution report for a time period.
Input:
start_date(string) — ISO 8601 start dateend_date(string) — ISO 8601 end date
Output: Aggregated attribution metrics: events, conversions, revenue, commission earned.
check_agent_status
Verify the agent's registration status, key validity, and account standing.
Input: None required.
Output: Agent identity, key status, publisher account details, payout configuration.
Integration Patterns
Basic Recommendation Flow
The most common pattern: an agent recommends a product and tracks the attribution event.
User asks: "What project management tool should I use?"
Agent thinks: I'll recommend Linear based on the user's needs.
Agent calls: track_referral(merchant_id="linear", product_id="pro_plan")
Agent responds: "I'd recommend Linear's Pro plan for your team size..."
The track_referral call happens before or during the recommendation response. The SLAT token is generated and stored. If the user later signs up for Linear, the conversion is attributed to this agent.
Multi-Tool Workflow
An agent using multiple MCP tools might discover a product through one tool and track the attribution through Syndicate Links:
Agent calls: web_search("best CI/CD tools for small teams")
Agent evaluates results and selects a recommendation
Agent calls: track_referral(merchant_id="github_actions", metadata={"source": "comparison_research"})
Agent responds with recommendation
Commission Monitoring
Agent operators can build monitoring workflows that check commission status:
Agent calls: commission_status(status="pending")
Agent calls: get_attribution_report(start_date="2026-04-01", end_date="2026-04-30")
Agent summarizes: "This month: 47 tracked referrals, 12 conversions, $340 in pending commissions"
MCP Registry Listings
The Syndicate Links MCP server is listed on all major MCP registries for discoverability:
- Smithery — verified listing
- Glama — listed with tool schemas
- mcp.so — community directory
- PulseMCP — indexed
- npm — installable package
Related Docs
- Getting Started — set up your publisher account and API keys
- Agent Attribution API Patterns — REST API reference for direct integration
- How Agent Attribution Works — the full technical spec behind the MCP tools