Uppercut

Merchant MCP

Run your affiliate program from your agent.

Merchant MCP gives Claude, Cursor or any MCP client access to one Uppercut team. It can create campaigns, review sales, check tracking, manage affiliates and set up payouts.

Connect in app Agent connect guide

TL;DR

  1. 01

    Live in the app. Connect at app.uppercut.co/agents/mcp.

  2. 02

    Sign in with OAuth 2.1 and PKCE. Each connection covers one team and sends a Bearer token to /mcp.

  3. 03

    18 tools for running the program. Sales are still recorded through Stripe or the REST API.

  4. 04

    No anonymous API keys, no tokens that span teams, and no unauthenticated access.

Connect flow

  1. 01

    Point the client at MCP

    Send requests to POST https://app.uppercut.co/mcp over streamable HTTP.

  2. 02

    Discover or register OAuth

    The client reads the .well-known metadata, or registers itself at /oauth/register with Dynamic Client Registration.

  3. 03

    Sign in and pick one team

    On the consent screen, choose the merchant team and click Allow.

  4. 04

    Call tools with the token

    Send the Bearer access token (uca_…) to /mcp. Scopes are merchant:read and merchant:write.

Scopes

OAuth 2.1 with PKCE for public clients. Every token is scoped to one team.

merchant:read
Every list and read tool
merchant:write
Create and update campaigns and destinations, remove affiliates, approve or reject sales, upload assets, and create a payout funding link

Tools

Eighteen tools for running the program. Write tools need merchant:write.

Setup / status

  • validate_tracking

    Checks that click, signup and sale tracking are working

  • read_status_board

    Reads the tasks on your merchant status board

  • lookup_docs

    Finds the right page on docs.uppercut.co

Programs

  • create_campaign

    Takes a name, reward_type and reward_value, plus optional windows and a destination

  • get_campaign / update_campaign

    Read or change a campaign

  • add_destination

    Add a landing page to a campaign

Affiliates

  • list_affiliates / search_affiliates / get_affiliate

    Find and inspect affiliates

  • remove_affiliate

    Needs a reason and refuses while the affiliate has open sales. Removed affiliates can never rejoin.

Sales & leads

  • list_sales / approve_sale / reject_sale

    Review conversions before they pay out

  • list_leads

    Signups with email or user ID and the affiliate who referred them

Assets & payouts

  • list_assets / upload_asset

    List creative assets, or upload one from a public URL

  • add_payout_method

    Returns a Stripe Checkout link for adding a funding method

Write tools: create_campaign, update_campaign, add_destination, remove_affiliate, approve_sale, reject_sale, upload_asset, add_payout_method

Example prompts

  • “Read my status board”
  • “List leads with email and affiliate”
  • “Validate tracking”
  • “Create a 20% campaign for Acme”

Endpoints

MCP runs the program. Sales are still recorded through Stripe or the REST API at /api/track-sale.

MCP server card llms.txt App agents hub Docs

FAQ

Common questions

Is Merchant MCP the same as the sales API? +

No. MCP runs the program for one signed-in team. Sales are still recorded through Stripe or the REST API, including /api/track-sale. Most setups use both: MCP to run the program, Stripe or REST to attribute sales.

Do I need an API key for MCP? +

No. You connect with OAuth 2.1 and PKCE. After you sign in and click Allow, the client gets a Bearer token scoped to one team. MCP has no unauthenticated access and no anonymous API keys.

Can one connection manage multiple teams? +

No. The consent screen picks one team and the token only works for that team. To switch, reconnect and choose a different team.

Where do agents find how to connect? +

Start with /llms.txt and /.well-known/mcp.json on uppercut.co, or read the connect guide at /mcp.md. Interactive setup is at app.uppercut.co/agents/mcp.

Connect your MCP client.

Open setup in the app, point Claude or Cursor at https://app.uppercut.co/mcp, and approve one team.

Open MCP setup Read mcp.md