MCP Server

Partnero’s MCP (Model Context Protocol) server lets you manage your affiliate or referral program directly from AI assistants. Instead of navigating the dashboard, you can use natural language commands to manage partners, customers, transactions, and more.

MCP is an open standard that enables AI assistants to securely interact with external tools and data sources. Learn more at modelcontextprotocol.io.

Supported AI Tools

Claude — desktop and web, as a custom connector over OAuth
ChatGPT — as a custom connector over OAuth
Grok — as a custom connector
Lovable — as a chat connector, for context while you build
Cursor — as a plugin that adds the server plus integration skills
VS Code — With MCP extension
Claude Code CLI — Command-line interface

What You Can Do

Once connected, your AI assistant can manage your entire Partnero program:

Partners

List, search, create, update, archive, and restore partners, pay bonuses, and issue referral links

Customers

Manage customers, view transactions and stats

Transactions

List, create, and manage transactions (triggers commissions)

Leads

List, manage, convert, or reject leads

Rewards

View rewards and balances

Program

Access program overview and update tracking and portal settings

Webhooks

List available events and manage the endpoints they are sent to

Authentication

There are two ways to connect, and the right one depends on your AI tool:

OAuth — for apps that accept a connector URL, such as Claude and ChatGPT. You sign in to Partnero in the browser and pick the program to grant. Nothing is stored in a configuration file and there is no key to rotate.
API key — for tools configured from a file, such as Cursor, VS Code and the Claude Code CLI.

Connect with OAuth

Copy the MCP URL

In Partnero, go to Integration → MCP, switch Authentication to OAuth and copy the server URL:

https://api.partnero.com/mcp

Add it as a custom connector

In Claude or ChatGPT, add a custom connector and paste the URL. The app discovers everything else on its own — no configuration file, no manually registered client.

The app opens Partnero in your browser. Log in, choose the program the assistant should manage, and approve the request.

A grant covers one program. To let an assistant work on a second program, connect it again and choose that program — you’ll be asked once per program.

Managing connections

Connected apps are listed under Integration → MCP → Connected apps, with who authorized each one and when it was last used. Disconnect revokes access immediately; the app has to be authorized again to come back.

Connect with an API Key

Get Your API Key

Log in to Partnero
Go to Integration → MCP
Generate and copy your API key

Keep your API key secure—it provides full access to your program data.

Configure Your AI Tool

Choose your AI tool and add the configuration below. Replace YOUR_API_KEY with your actual API key.

Claude Desktop
Cursor
VS Code
Claude Code CLI

Add to your Claude Desktop configuration file:macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "partnero": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.partnero.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):

{
  "mcpServers": {
    "partnero": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.partnero.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Add to your VS Code MCP settings:

{
  "mcpServers": {
    "partnero": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.partnero.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Run the following command:

claude mcp add partnero -- npx mcp-remote https://api.partnero.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Restart Your AI Tool

Close and reopen your AI application for the changes to take effect.

Example Prompts

Once connected, you can interact with Partnero using natural language. Your assistant picks the right tools on its own, so you can describe what you want rather than naming endpoints.

Measure performance

Rank partners by the signups, sales and revenue they have brought in, or pull the program totals in one go.

“Who are my top 10 partners by revenue?”
“Which partners have referred the most signups?”
“Give me an overview of my program”
“What’s the total pending commission?”
“How many customers has partner_abc referred, and what have they spent?”

Find partners and customers

Search by part of a name, email or ID — you don’t need the exact value — and trace a customer back to the partner who referred them.

“Find the partner called Sarah”
“Show me the partners with an acme.com email address”
“Who referred the customer [email protected]?”
“Show me everything about partner partner_abc”
“Is [email protected] already registered as a partner?”

Manage partners

Add and update partners, archive and restore them, pay a one-off bonus, and hand out campaign-specific referral links.

“Create a partner for [email protected] called Jane Doe”
“Update partner_abc’s surname to Smith”
“Give partner_abc a 50 bonus for the Q3 push”
“Create a referral link for partner_abc with the key summer-sale”
“What referral links does partner_abc have?”
“Archive partner_abc” / “Restore partner_abc”

Track referrals and sales

Register customers against a partner, record transactions that trigger commissions, and review a single customer’s history.

“Create a customer for [email protected] and link them to partner_abc”
“Record a 120 sale for customer cust_123”
“Show me the transactions attributed to partner_abc”
“What has customer cust_123 bought?”
“Archive transaction txn_123 — it was refunded”

Work through leads

List incoming leads, convert the ones that signed up, and reject the rest.

“Show me the open leads”
“Convert the lead from acme.com”
“Reject lead lead_123 as spam”

Adjust program settings

Read the current configuration and change the settings that shape how partners sign up and get tracked.

“What’s our referral cookie lifetime?”
“What are my current commission rates?”
“Set the cookie lifetime to 60 days”
“Turn on passwordless login for the partner portal”
“Stop new partners signing up through the portal”

Wire up webhooks

See which events this program can emit, then create, edit or remove the endpoints they are sent to.

“What webhooks do we have, and what events can I subscribe to?”
“Send partner.created events to https://example.com/hooks”
“Add transaction.created to the shipping-hook webhook”
“Pause the shipping-hook webhook”
“Delete the webhook pointing at staging.example.com”

Rate Limits

Resource	Limit
Tool calls	360 requests/minute
SSE connections	5 per IP/minute

If you hit rate limits, wait a minute before retrying or batch your requests.

Troubleshooting

401 Unauthorized

On an API key connection:

Verify your API key is correct
Check that the Authorization header is properly formatted: Bearer YOUR_API_KEY
Regenerate your API key from the Partnero dashboard

On an OAuth connection:

Check the app still appears under Integration → MCP → Connected apps; if it was disconnected, authorize it again
Remove and re-add the connector so it runs the sign-in flow from scratch

Tool Not Appearing

Restart your AI application completely
Verify the MCP configuration file is in the correct location
Check for JSON syntax errors in your configuration

429 Too Many Requests

Wait 60 seconds before making more requests
Reduce request frequency
Batch multiple operations into single requests when possible

Connection Issues

Ensure Node.js 18+ is installed: node --version
Check your internet connection
Verify the MCP endpoint URL is correct: https://api.partnero.com/mcp

Next Steps

API Reference

Explore the full REST API for programmatic access

AI Prompts

Copy-paste prompts for AI coding assistants

Getting started

Programs

Tracking integration

No-code solutions

Postbacks

Webhooks

AI & MCP

Supported AI Tools

What You Can Do

Partners

Customers

Transactions

Leads

Rewards

Program

Webhooks

Authentication

Connect with OAuth

Managing connections

Connect with an API Key

Example Prompts

Rate Limits

Troubleshooting

Next Steps

API Reference

AI Prompts

​Supported AI Tools

​What You Can Do

Partners

Customers

Transactions

Leads

Rewards

Program

Webhooks

​Authentication

​Connect with OAuth

​Managing connections

​Connect with an API Key

​Example Prompts

​Rate Limits

​Troubleshooting

​Next Steps

API Reference

AI Prompts

Supported AI Tools

What You Can Do

Authentication

Connect with OAuth

Managing connections

Connect with an API Key

Example Prompts

Rate Limits

Troubleshooting

Next Steps