Now with MCP · your agent can query commission, affiliates, and payouts. Read-only. Connect a client

Documentation

Set up your program
in about ten minutes.

Sign up, wire the webhook, drop the script, share your join link. Every provider Sled speaks, end to end.
Get live in 5 minutes

1. Quick start

  1. Sign up with your email. You'll get a magic link.
  2. Name your program. Pick a slug (e.g. acme) and set your commission % (default 30%).
  3. Connect Polar in /dashboard/settings, paste your Polar webhook secret, add our webhook URL in Polar.
  4. Set your website URL in /dashboard/settings. Affiliate links will be built off this, e.g. https://yoursite.com/?ref=abc1234.
  5. Drop the tracking script on that same site, so the ?ref= cookie is captured when affiliates send traffic.
  6. Share https://usesled.com/acme/join with potential affiliates. They sign up and get their own link.
10-day free trial. No credit card needed. Upgrade to Pro ($19/mo, code LAUNCH7 gets $7 off each of your first 3 months) before it ends to keep your dashboard.
The flow

2. How attribution works

An affiliate sale follows this chain:

  1. An affiliate shares their link, e.g. https://yoursite.com/?ref=abc1234 (domain comes from your “Your website” setting)
  2. A visitor clicks it. Our tracking script reads ?ref=abc1234 and stores it in a ta_ref cookie (90 days default).
  3. The visitor browses your site, eventually buys something through Polar / Stripe / etc.
  4. Your checkout code passes the cookie value as metadata.referral to the payment provider.
  5. The provider fires a webhook to Sled. We look up the referral code → match it to an affiliate → record the conversion + commission.
  6. Your affiliate sees the sale in their dashboard. You see it in yours.
You don't need to add anything to your checkout success page. Attribution happens server-side via the webhook, not client-side.
Recommended

3. Polar.sh integration

Step 1: Add the webhook in Polar

In your Polar dashboard → Settings → Webhooks → Add endpoint:

FieldValue
URLhttps://usesled.com/acme/api/webhook/polar
Eventsorder.created, order.paid, order.refunded, subscription.canceled

Copy the signing secret Polar generates. You'll paste it in your Sled settings.

Step 2: Paste the secret in Sled

Go to /dashboard/settings → Polar webhook secret → paste the value → save.

Step 3: Attach the referral cookie in your checkout

Wherever you create a Polar checkout session, attach the ta_ref cookie value as metadata:

import { Polar } from "@polar-sh/sdk";

const polar = new Polar({ accessToken: process.env.POLAR_ACCESS_TOKEN });

const checkout = await polar.checkouts.create({
  products: [productId],
  successUrl: "https://yourapp.com/thanks",
  metadata: {
    referral: req.cookies.ta_ref ?? "",
  },
});

That's it. When a referred customer pays, the conversion appears in /dashboard within seconds.

Using a static Checkout Link instead?

If you send customers to a Polar Checkout Link (a payment link you copied from the Polar dashboard) rather than creating the checkout through the API, Polar won't let you attach arbitrary metadata, the code sample above doesn't apply. Append the referral as reference_id instead:

https://buy.polar.sh/polar_cl_xxx?reference_id=<ta_ref cookie value>

Sled reads reference_id and custom_field_data.referral as fallbacks for metadata.referral, so either surface attributes correctly. You still need to read the ta_ref cookie and build the link with it, a bare link with no reference_id records the sale with no affiliate attached.

UTM parameters are not used for attribution. Ads, newsletters and organic links set them too, so trusting them would credit affiliates for traffic they never sent. Use reference_id.
Free trials: if your plan starts with a $0 trial, the initial order.created / order.paid event shows up as ignored in your webhook log, no commission on $0, as expected. The referral isn't lost: we save it against the subscription id, and the first real charge (trial end, or any later renewal) attributes to the same affiliate automatically, even though that charge's webhook doesn't carry the original checkout metadata.
Also supported

4. Stripe integration

Webhook URL: https://usesled.com/acme/api/webhook/stripe

Events: checkout.session.completed, charge.refunded

Pass the referral in checkout session metadata:

const session = await stripe.checkout.sessions.create({
  // ...your existing fields
  metadata: { referral: getCookie("ta_ref") || "" },
});

Paste the Stripe signing secret in /dashboard/settings → Stripe webhook secret.

Native, signed webhooks

5. Paddle integration

Webhook URL: https://usesled.com/acme/api/webhook/paddle

Events: transaction.completed, adjustment.created, adjustment.updated, subscription.canceled

Pass the referral in checkout custom data:

const checkout = await paddle.checkouts.create({
  items: [{ priceId, quantity: 1 }],
  customData: { referral: getCookie("ta_ref") || "" },
});

Paste the Paddle notification secret in /dashboard/settings → Paddle webhook secret. Paddle signs every delivery with Paddle-Signature (HMAC-SHA256) and Sled verifies it before crediting anything. Refunds and chargebacks arrive as approved adjustment events and claw commission back automatically; renewals inherit the original affiliate via the subscription id.

Any provider that can POST JSON

6. Other providers

For any provider that can POST JSON, use our generic webhook. POST to https://usesled.com/acme/api/webhook/generic:

{
  "event": "order",
  "orderId": "ord_12345",
  "amount": 4900,
  "email": "customer@example.com",
  "metadata": { "referral": "abc1234" }
}

For refunds:

{ "event": "refund", "orderId": "ord_12345" }

Set a shared secret in /dashboard/settings → Generic webhook secret → and send it on every request as either X-Webhook-Secret: yoursecret or Authorization: Bearer yoursecret.

Amounts are always in cents.

Drop this on your site

7. Tracking script

Embed on any page where affiliate links land (usually your marketing site root):

<script async src="https://usesled.com/acme/t.js"></script>
Install it on the same domain you set as “Your website” in /dashboard/settings. That's where affiliates' ?ref= links will land, if the script isn't there, the cookie never gets set and clicks aren't tracked.

What it does, in order:

  1. Reads ?ref=CODE from the URL.
  2. Stores CODE in a ta_ref cookie for the configured attribution window (90 days default).
  3. Pings https://usesled.com/acme/api/click to record the click. We dedupe by IP for 24 hours so refreshes don't inflate stats.

It's less than 1KB minified. No external dependencies. No third-party calls.

The people referring you

8. Affiliates

Inviting them

Share https://usesled.com/acme/join. Anyone with the link can sign up, name + email, that's it. They immediately get their affiliate link.

What they see

  • Their unique referral link, built off the URL you set as “Your website” in /dashboard/settings
  • Click count, conversion count, revenue, earnings
  • Pending vs paid amounts
  • A form to add payout details (PayPal, Wise, IBAN, crypto wallet), only after they earn their first commission

Managing them

In /dashboard/affiliates you see everyone's stats, clicks, conversions, owed, payout method.

Get discovered (optional)

Turn on List in the Sled affiliate directory in /dashboard/settings to let signed-in affiliates find your program at /affiliate/discover and apply. Applications land under /dashboard/affiliates as Pending, you Approve or Decline each one, so nothing goes live without your OK. It's off by default, and your direct /join link still works for instant sign-ups.

You move the money

9. Payouts

Sled doesn't move money for you. We track who's owed what, you send payments manually from your own PayPal / Wise / bank / crypto wallet.

This means: no KYC, no payment processing fees, no compliance overhead. Just a clean ledger.

The flow

  1. Open /dashboard/payouts. Affiliates above your minimum threshold appear in Ready for payout.
  2. Each row shows their payment method (PayPal / Wise / Bank / Crypto) and destination (email / IBAN / wallet address).
  3. You send the payment manually.
  4. Click Mark paid in the admin, the affiliate gets an email confirming, their pending balance resets.

Set your minimum payout threshold in /dashboard/settings. Default is $20.

What we send

10. Email notifications

We send 3 transactional emails on your behalf:

  • Welcome, when an affiliate signs up, with their dashboard URL and referral link.
  • First commission, when an affiliate earns their first conversion, prompting them to add payout details.
  • Payout sent, when you click Mark paid in the admin.

Emails are sent from affiliates@usesled.com with your program name in the From field, affiliates see “acme · affiliate program” as the sender.

Configurable per-program

11. Settings

SettingWhat it does
Program nameShown to affiliates on signup and in emails.
Your websiteBase URL for affiliate referral links. Affiliates will share https://yoursite.com/?ref=CODE. Install the tracking script on this same domain.
Commission %Default 30%. Applied to every conversion.
Cookie daysHow long the ref cookie lives. Default 90.
Minimum payoutBelow this, affiliates aren't shown in 'Ready for payout'.
Polar webhook secretRequired to verify Polar webhooks.
Stripe webhook secretRequired if you use Stripe.
Paddle webhook secretRequired if you use Paddle.
Generic webhook secretRequired if you use the generic webhook.
Read-only reporting for LLM clients

12. AI agents (MCP)

Sled runs an MCP server at https://usesled.com/api/mcp. Any MCP client (Claude Code, Cursor, VS Code, opencode, your own agent) can read your program with a Sled API key: clicks, conversions, commission, payouts and recent activity. No scraping the dashboard, no CSV round-trips.

Every tool is read-only and locked to the program that owns the key. An agent cannot change your commission rate, approve affiliates, record a payout, or move money. Keys are stored hashed and revocable at any time in Settings.

Setup

  1. Open /dashboard/settings and create a key under AI agents. It is displayed once, so copy it straight away.
  2. Add Sled to your client's MCP config:
{
  "mcpServers": {
    "sled": {
      "type": "http",
      "url": "https://usesled.com/api/mcp",
      "headers": { "Authorization": "Bearer sled_sk_..." }
    }
  }
}

Clients that take a URL plus an auth header instead of a config file use the same endpoint. Discovery metadata for agents lives at /.well-known/mcp/server-card.json.

Client support today: Claude Code, Cursor, VS Code and opencode connect with a static bearer header. claude.ai custom connectors can do the same through their static header support (beta, an admin enters the key once). ChatGPT connectors require OAuth 2.1, which Sled does not serve yet, so ChatGPT is not supported for now.

Protocol: dual-era. Modern clients (revision 2026-07-28, stateless per-request metadata plus server/discover) and legacy clients (the initialize handshake, 2025-11-25 and earlier) both work against this one endpoint. Requests are capped at 120/minute per key and 300/minute per IP address, and browsers are only accepted from allowlisted origins: MCP clients call server to server, without an Origin header.

Easy setup: copy a prompt

Fastest path. Paste this into whichever agent you already have open (Claude Code, Cursor, VS Code, opencode) and it writes the config for that client, saves it, verifies the connection and reports back.

Add the Sled MCP server to the AI client you are running in, so you can read my affiliate program.

Endpoint: POST https://usesled.com/api/mcp (MCP over HTTP, JSON-RPC 2.0, Streamable HTTP)
Auth: send the header "Authorization: Bearer sled_sk_... (ask me for it)"
Discovery card: https://usesled.com/.well-known/mcp/server-card.json
Tools (all read-only, one program each): get_program_overview, get_metrics, list_affiliates, get_affiliate, list_conversions, list_payouts, get_activity_feed

Do this:
1. Write the MCP config in the format your client uses, then save it and tell me exactly which file you changed.
   - Claude Code / Cursor style:
{
  "mcpServers": {
    "sled": {
      "type": "http",
      "url": "https://usesled.com/api/mcp",
      "headers": { "Authorization": "Bearer sled_sk_..." }
    }
  }
}
   - opencode style:
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sled": {
      "type": "remote",
      "url": "https://usesled.com/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer sled_sk_..." }
    }
  }
}
2. Do not enable OAuth. This is a static Bearer key, and Sled has no OAuth server, so an OAuth flow will just fail.
3. Verify the connection by calling get_program_overview, then answer: how is my affiliate program doing right now, and what changed in the last 30 days?

Note: Sled shows an API key only once, when it is created (Dashboard, then Settings, then "AI agents"). If you need one, ask me and I will paste it.

opencode

opencode keeps MCP servers under an mcp block in~/.config/opencode/opencode.json (or a project opencode.json). oauth: false matters: Sled uses a static Bearer key and has no OAuth server, so an automatic OAuth attempt can only fail.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sled": {
      "type": "remote",
      "url": "https://usesled.com/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer sled_sk_..." }
    }
  }
}

Check it landed with opencode mcp list, then ask something like use the sled tool: how did my program do this month?

Tools

ToolWhat it returns
get_program_overviewLifetime totals and your program config (commission %, cookie days, minimum payout). Start here.
get_metricsRevenue, commission, first orders vs renewals, clicks, new affiliates and derived rates for a date range. Defaults to the last 30 days.
list_affiliatesAffiliates with clicks, conversions, revenue, commission, paid and payable. Sort by revenue, commission, payable, clicks or conversions.
get_affiliateOne affiliate in full, by referral code or email.
list_conversionsIndividual attributed orders: order id, affiliate, amount, commission, provider, renewal flag, status.
list_payoutsRecorded payouts with method and date, plus total paid and what is still payable.
get_activity_feedNewest events: joins, first sales, renewals, refunds and payouts.

Money comes back as USD (cents plus a formatted string such as $412.50) and every date filter is UTC and inclusive on both ends. Refunded conversions stay visible instead of disappearing, so clawed-back money can't be mistaken for revenue.

Things worth asking

  • “How much commission did Sarah drive this quarter, and how much is still owed to her?”
  • “Which affiliates have real clicks but zero conversions?”
  • “Summarize my affiliate program up to today: revenue, top three affiliates, anything refunded.”
What you get

13. Plans

Free trialPro
Price$0 for 10 days$19/mo
code LAUNCH7: $12/mo first 3 months
Max affiliatesUnlimitedUnlimited
All webhooks✓✓
Email notifications✓✓
Priority support-✓

See full pricing & FAQ on the pricing page.

When things break

14. Troubleshooting

SymptomFix
Webhook not arrivingSend a test event from the Polar dashboard. Check that the webhook URL matches your slug exactly (no typos).
Conversion not recordedYour checkout's metadata.referral was empty. Verify your checkout code reads the ta_ref cookie before creating the session.
Affiliate code not detectedThe ta_ref cookie didn't set. Make sure ?ref= was in the URL when the visitor first arrived on your site, and that the tracking script is loaded on that domain.
Affiliate links show usesled.com instead of my siteSet “Your website” in /dashboard/settings. Existing affiliates need to re-copy their link from their dashboard, Sled doesn't rewrite links they've already shared.
Changed my website URL but old shared links still go to the old domainBy design. Sled doesn't auto-rewrite links affiliates have already shared publicly. Ask them to grab the new link from their dashboard, or set up a redirect from the old domain to the new one yourself.
Affiliate can't access their dashboardThe dashboard URL is their secret, they should bookmark it. If lost, you can find their code in /dashboard/affiliates and resend the URL.
Wrong commission amountCheck the commission % in /dashboard/settings. Changes apply to NEW conversions only.
Dashboard locked, affiliate signups blockedYour 10-day free trial ended. Upgrade to Pro and everything unlocks right away. Nothing was deleted.

Still stuck?

Email hey@ardakaanozcan.com goes straight to the founder. Pro plan customers get priority response.