{
  "$schema": "https://syndicatelinks.co/.well-known/agent-schema.json",
  "name": "Syndicate Links",
  "description": "Commission infrastructure for AI-driven commerce. Attribution, conversion tracking, and payout settlement for AI agents, publishers, and merchants.",
  "url": "https://syndicatelinks.co",
  "logo": "https://syndicatelinks.co/logo-ink.svg",
  "contact": "hello@syndicatelinks.co",
  "category": "commerce-infrastructure",
  "tags": [
    "attribution",
    "affiliate",
    "commission",
    "ai-agents",
    "mcp",
    "commerce",
    "payouts"
  ],
  "capabilities": {
    "summary": "Syndicate Links lets AI agents earn commissions on product recommendations. Agents discover merchant programs, generate signed attribution tokens, and get paid when users purchase.",
    "for_agents": {
      "description": "AI agents can discover affiliate programs, generate attribution tokens for product recommendations, track conversions, and earn commissions \u2014 all via REST API or MCP.",
      "value_proposition": "When your agent recommends a product and the user buys, your agent earns a commission. No cookies, no browser required.",
      "getting_started_url": "https://syndicatelinks.co/docs/getting-started",
      "skill_pack_repository": "https://github.com/syndicatelinks/attribution-skills",
      "skill_pack_install": "npx skills add syndicatelinks/attribution-skills",
      "quickstart_steps": [
        "Register at POST /affiliate/register to get an API key",
        "Discover programs at GET /affiliate/programs",
        "Apply to a program at POST /affiliate/programs/:id/apply",
        "Generate tracking links at POST /affiliate/links",
        "Check earnings at GET /affiliate/me/balance"
      ]
    },
    "for_merchants": {
      "description": "Merchants create affiliate programs, list products, and track which AI agents or publishers drive real sales. Record conversions and let the platform handle commission calculation and payout.",
      "getting_started_url": "https://syndicatelinks.co/docs/getting-started"
    }
  },
  "api": {
    "base_url": "https://api.syndicatelinks.co",
    "docs_url": "https://syndicatelinks.co/docs/api-reference",
    "authentication": {
      "type": "bearer",
      "header": "Authorization",
      "format": "Bearer <api_key>",
      "key_prefixes": {
        "mk_live_": "Merchant key \u2014 program management, conversion recording, reports",
        "ak_live_": "Affiliate/publisher key \u2014 program discovery, tracking links, earnings",
        "aff_agent_": "Agent-scoped key \u2014 attribution tracking, commission queries via MCP"
      }
    },
    "rate_limits": {
      "starter": {
        "per_minute": 60,
        "per_day": 1000
      },
      "pro": {
        "per_minute": 300,
        "per_day": 25000
      },
      "enterprise": "custom"
    },
    "endpoints": {
      "agent": [
        {
          "method": "POST",
          "path": "/affiliate/register",
          "description": "Create an agent/affiliate account and get an API key",
          "auth_required": false,
          "body": {
            "email": "string",
            "name": "string"
          }
        },
        {
          "method": "GET",
          "path": "/affiliate/programs",
          "description": "Discover available affiliate programs to join",
          "auth_required": true
        },
        {
          "method": "GET",
          "path": "/affiliate/programs/:id",
          "description": "Get full details of a specific program",
          "auth_required": true
        },
        {
          "method": "GET",
          "path": "/affiliate/programs/:id/products",
          "description": "List products in a program",
          "auth_required": true
        },
        {
          "method": "GET",
          "path": "/affiliate/products/search",
          "description": "Search products across all programs",
          "auth_required": true,
          "query_params": {
            "q": "Search query string"
          }
        },
        {
          "method": "POST",
          "path": "/affiliate/programs/:id/apply",
          "description": "Apply to join an affiliate program",
          "auth_required": true
        },
        {
          "method": "POST",
          "path": "/affiliate/links",
          "description": "Generate a tracking link for a program/product",
          "auth_required": true,
          "body": {
            "program_id": "string",
            "product_id": "string (optional)",
            "custom_tag": "string (optional)"
          }
        },
        {
          "method": "POST",
          "path": "/affiliate/events/click",
          "description": "Record a click event on a tracking link",
          "auth_required": true,
          "body": {
            "tracking_link_id": "string",
            "ip_address": "string (optional)",
            "user_agent": "string (optional)"
          }
        },
        {
          "method": "POST",
          "path": "/affiliate/events/conversion",
          "description": "Record a conversion (sale) attributed to a click",
          "auth_required": true,
          "body": {
            "click_id": "string",
            "sale_amount": "number",
            "order_id": "string"
          }
        },
        {
          "method": "POST",
          "path": "/v1/track/ai-referral",
          "description": "Record an AI agent referral event with surface context",
          "auth_required": true,
          "body": {
            "event": "ai_referral",
            "ai_surface": "chat | voice | search | autonomous | browser",
            "orderValue": "number"
          }
        },
        {
          "method": "GET",
          "path": "/affiliate/me/balance",
          "description": "Check earned commission balance",
          "auth_required": true
        },
        {
          "method": "GET",
          "path": "/affiliate/me/payouts",
          "description": "Get payout history",
          "auth_required": true
        },
        {
          "method": "GET",
          "path": "/affiliate/reports/earnings",
          "description": "Detailed earnings report with date filtering",
          "auth_required": true,
          "query_params": {
            "from": "YYYY-MM-DD",
            "to": "YYYY-MM-DD"
          }
        },
        {
          "method": "GET",
          "path": "/v1/reports/ai-endorsements",
          "description": "FTC-ready audit trail — every AI endorsement with agent identity, merchant, order, and timestamp",
          "auth_required": true
        }
      ],
      "merchant": [
        {
          "method": "POST",
          "path": "/merchant/register",
          "description": "Create a merchant account",
          "auth_required": false,
          "body": {
            "name": "string",
            "email": "string",
            "website": "string"
          }
        },
        {
          "method": "POST",
          "path": "/merchant/programs",
          "description": "Create an affiliate program",
          "auth_required": true,
          "body": {
            "name": "string",
            "description": "string",
            "commission_rate": "number",
            "commission_type": "percentage | flat",
            "cookie_duration_days": "number"
          }
        },
        {
          "method": "POST",
          "path": "/merchant/products",
          "description": "Add a product to a program",
          "auth_required": true,
          "body": {
            "name": "string",
            "url": "string",
            "price": "number",
            "program_id": "string"
          }
        },
        {
          "method": "POST",
          "path": "/merchant/conversions",
          "description": "Record a conversion event",
          "auth_required": true,
          "body": {
            "order_id": "string",
            "sale_amount": "number",
            "currency": "string",
            "click_id": "string"
          }
        },
        {
          "method": "GET",
          "path": "/merchant/reports",
          "description": "Revenue and attribution reports",
          "auth_required": true,
          "query_params": {
            "from": "YYYY-MM-DD",
            "to": "YYYY-MM-DD"
          }
        }
      ]
    },
    "developer": {
      "description": "For platforms that need attribution services without the full merchant feature set. Pay per attribution event — no seats, no monthly minimum.",
      "tiers": [
        {
          "name": "Free",
          "events_per_month": "5,000",
          "price": "$0"
        },
        {
          "name": "Usage",
          "price": "$0.001 per event after free tier",
          "payment": "Stripe or x402"
        },
        {
          "name": "Enterprise",
          "price": "Custom (SLA, dedicated AM)"
        }
      ]
    }
  },
  "agent_payment_discovery": {
    "descriptor_url": "https://syndicatelinks.co/.well-known/agent-payments",
    "descriptor_json_url": "https://syndicatelinks.co/.well-known/agent-payments.json",
    "machine_payments_url": "https://api.syndicatelinks.co/.well-known/machine-payments",
    "safety": "Only create checkout sessions, create invoices, or submit payments after explicit user payment intent.",
    "flows": [
      {
        "id": "merchant_stripe_checkout",
        "method": "POST",
        "url": "https://api.syndicatelinks.co/merchant/billing/checkout",
        "auth_required": true,
        "description": "Create a Stripe Checkout URL for merchant subscription billing."
      },
      {
        "id": "merchant_crypto_invoice",
        "method": "POST",
        "url": "https://api.syndicatelinks.co/merchant/billing/crypto/invoice",
        "auth_required": true,
        "description": "Create or reuse an annual Pro merchant invoice payable by Bitcoin Lightning through BTCPay or USDC on Base."
      },
      {
        "id": "merchant_crypto_invoice_status",
        "method": "GET",
        "url": "https://api.syndicatelinks.co/merchant/billing/crypto/invoice/{invoiceId}",
        "auth_required": true,
        "description": "Poll a merchant crypto invoice until paid, expired, or cancelled."
      },
      {
        "id": "x402_tracking_link_request",
        "method": "POST",
        "url": "https://api.syndicatelinks.co/affiliate/links",
        "auth_required": "bearer API key preferred; x402 challenge available for unauthenticated paid requests",
        "description": "x402-paid entry point for agent requests to the tracking-link endpoint."
      }
    ]
  },
  "webhooks": {
    "events": [
      "conversion.created",
      "affiliate.applied",
      "payout.completed"
    ],
    "signature": "HMAC-SHA256 in X-Signature header"
  },
  "mcp": {
    "description": "Model Context Protocol server for AI agent integration. 7 tools for program discovery, attribution, and commission tracking.",
    "npm_package": "syndicate-links-mcp",
    "install": "npx syndicate-links-mcp",
    "remote_endpoint": "https://mcp.syndicatelinks.co/mcp",
    "transport": [
      "stdio",
      "streamable-http"
    ],
    "config_example": {
      "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"
          }
        }
      }
    },
    "tools": [
      {
        "name": "search_programs",
        "description": "Find affiliate programs by keyword",
        "input": {
          "query": "string"
        }
      },
      {
        "name": "get_program_details",
        "description": "Get full program info \u2014 commission rates, terms, merchant details",
        "input": {
          "program_id": "string"
        }
      },
      {
        "name": "list_merchant_programs",
        "description": "List your own merchant programs (merchant key required)",
        "input": {}
      },
      {
        "name": "track_agent_conversion",
        "description": "Record a conversion with a signed attribution token",
        "input": {
          "attribution_token": "string",
          "order_id": "string",
          "amount": "number",
          "currency": "string"
        }
      },
      {
        "name": "verify_attribution_token",
        "description": "Validate a slat_v1_ token without submitting a conversion",
        "input": {
          "token": "string"
        }
      },
      {
        "name": "get_commission_status",
        "description": "Check your agent's earned commission balance",
        "input": {}
      },
      {
        "name": "run_payout_cycle",
        "description": "Trigger the global payout cycle (admin only)",
        "input": {}
      }
    ]
  },
  "agent_skills": {
    "manifest_url": "https://syndicatelinks.co/.well-known/agent-skills/index.json",
    "repository_url": "https://github.com/syndicatelinks/attribution-skills",
    "install_command": "npx skills add syndicatelinks/attribution-skills",
    "skills": [
      "syndicate-merchant-onboard",
      "syndicate-generate-tracking-link",
      "syndicate-fire-conversion"
    ],
    "description": "Portable attribution skills for AI agents that need reusable workflows for merchant onboarding, tracking link generation, and conversion firing."
  },
  "attribution": {
    "model": "token-based",
    "description": "Signed attribution tokens (slat_v1_ prefix) link agent recommendations to purchases. No cookies or browser required.",
    "flow": [
      "Agent calls POST /v1/attribution/token to mint a signed token (carries agent ID, merchant program, session context)",
      "Token is attached to the checkout/conversion event",
      "Platform validates token, calculates commission, and credits the agent",
      "Payout settles via the agent's preferred rail"
    ],
    "ai_surface_types": [
      "chat",
      "voice",
      "search",
      "autonomous",
      "browser"
    ],
    "spec_url": "https://syndicatelinks.co/docs/agent-attribution-spec"
  },
  "payment_rails": [
    {
      "name": "Stripe Connect",
      "currency": "USD",
      "settlement": "2-5 business days",
      "minimum": "$25"
    },
    {
      "name": "Bitcoin Lightning",
      "currency": "BTC",
      "provider": "BTCPay Server + Boltz",
      "settlement": "instant",
      "minimum": "$5"
    },
    {
      "name": "USDC on Base",
      "currency": "USDC",
      "provider": "Coinbase CDP",
      "settlement": "~2 seconds",
      "minimum": "$0.01"
    },
    {
      "name": "USDC on Solana",
      "currency": "USDC",
      "settlement": "instant",
      "minimum": "$0.01"
    }
  ],
  "pricing": {
    "url": "https://syndicatelinks.co/pricing",
    "model": "merchant-only. Publishers and AI agents join free \u2014 no monthly fee, no per-event fee. Merchants pay a small platform fee on commissions paid out.",
    "merchant_tiers": [
      {
        "name": "Starter",
        "price": "$0/month",
        "platform_fee": "5% of commissions paid out",
        "programs": 1,
        "publishers": "up to 50",
        "api_calls_per_day": 1000,
        "features": [
          "Pay only when publishers earn",
          "Basic dashboard",
          "Community support"
        ]
      },
      {
        "name": "Pro",
        "price": "$79/month",
        "platform_fee": "2.5% of commissions \u2014 scales down at volume",
        "programs": "unlimited",
        "publishers": "unlimited",
        "api_calls_per_day": 25000,
        "features": [
          "Advanced analytics & funnels",
          "Real-time webhooks",
          "Custom commission rules",
          "Priority fraud detection",
          "Priority support"
        ]
      },
      {
        "name": "Enterprise",
        "price": "Custom",
        "platform_fee": "Negotiated flat or % \u2014 you choose",
        "programs": "unlimited",
        "publishers": "unlimited",
        "api_calls_per_day": "100,000+",
        "features": [
          "Branded private publisher network",
          "Custom attribution models",
          "Competitor benchmarking",
          "SLA with uptime guarantee",
          "Dedicated account manager",
          "Multi-user team access"
        ]
      }
    ]
  },
  "docs": {
    "getting_started": "https://syndicatelinks.co/docs/getting-started",
    "api_reference": "https://syndicatelinks.co/docs/api-reference",
    "agent_attribution_spec": "https://syndicatelinks.co/docs/agent-attribution-spec",
    "acp_attribution": "https://syndicatelinks.co/docs/acp-attribution",
    "x402_attribution": "https://syndicatelinks.co/docs/x402-attribution",
    "stripe_mpp": "https://syndicatelinks.co/docs/stripe-mpp",
    "llms_txt": "https://syndicatelinks.co/llms.txt",
    "llms_full_txt": "https://syndicatelinks.co/llms-full.txt"
  },
  "services": {
    "aeo": {
      "name": "AEO Service (Answer Engine Optimization)",
      "description": "Make your site discoverable by AI agents. Full AEO implementation: llms.txt, agent.json, structured data, MCP integration, and attribution infrastructure. Delivered by AI agents.",
      "url": "https://syndicatelinks.co/services/aeo",
      "free_audit_url": "https://syndicatelinks.co/tools/agent-readiness-audit",
      "contact": "reagan@syndicatelinks.co",
      "tiers": [
        {
          "name": "Free Audit",
          "price": "$0",
          "description": "Automated Agent Readiness Score (0-100) across 5 categories"
        },
        {
          "name": "Audit + Roadmap",
          "price": "$500",
          "description": "Deep manual audit + prioritized remediation roadmap + narrated walkthrough"
        },
        {
          "name": "Full Implementation",
          "price": "$2,500+",
          "description": "Complete remediation: llms.txt, agent.json, structured data, MCP, attribution"
        },
        {
          "name": "Ongoing Retainer",
          "price": "$1,000+/mo",
          "description": "Monthly AEO monitoring, optimization, strategy briefing"
        }
      ]
    }
  },
  "social": {
    "x": "https://x.com/syndicatelinks",
    "npm": "https://www.npmjs.com/package/syndicate-links-mcp"
  },
  "agent_skills": {
    "manifest_url": "https://syndicatelinks.co/.well-known/agent-skills/index.json",
    "spec": "AgentSkills v0.2.0",
    "skills": [
      {
        "name": "syndicate-merchant-onboard",
        "type": "procedure",
        "description": "Cold-onboard a merchant end-to-end: register account, create program, add products, generate tracking links, fire a demo conversion. ~10 API calls, under 10 minutes.",
        "url": "https://syndicatelinks.co/.well-known/agent-skills/syndicate-merchant-onboard/SKILL.md"
      },
      {
        "name": "syndicate-fire-conversion",
        "type": "tool",
        "description": "Fire a conversion event against a tracking code with amount and optional order_id. Commission is auto-calculated from program settings.",
        "url": "https://syndicatelinks.co/.well-known/agent-skills/syndicate-fire-conversion/SKILL.md"
      },
      {
        "name": "syndicate-generate-tracking-link",
        "type": "tool",
        "description": "Generate a tracking link for an affiliate/program/product. Returns a short code and full click URL.",
        "url": "https://syndicatelinks.co/.well-known/agent-skills/syndicate-generate-tracking-link/SKILL.md"
      }
    ],
    "repository": "https://github.com/syndicatelinks/attribution-skills",
    "install": "npx skills add syndicatelinks/attribution-skills",
    "package_skills": [
      "syndicate-add-attribution",
      "syndicate-issue-agent-key",
      "syndicate-test-conversion"
    ]
  }
}