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 recommended
  • product_id (string, optional) — specific product or service
  • metadata (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, paid
  • limit (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, lightning
  • amount (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 category
  • sort (string, optional) — sort by commission_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 date
  • end_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: