> ## Documentation Index
> Fetch the complete documentation index at: https://docs.partnero.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect AI Assistants to Partnero with the MCP Server
Partnero's MCP (Model Context Protocol) server lets you manage your affiliate or referral program directly from AI assistants like Claude Desktop, Cursor, VS Code, and the Claude Code CLI.
Instead of clicking through the dashboard, you can ask things like:
* “Show me my top 10 partners this month”
* “Create a customer for and link them to partner partner\_abc”
The assistant will execute these actions through your Partnero account.
This guide explains what MCP is, how to connect it, and what you can do with it.
***
### What is MCP?
The Model Context Protocol is an open standard that enables AI assistants to securely interact with external tools and data sources.
The Partnero MCP server exposes your program’s data and actions (partners, customers, transactions, leads, rewards) so the assistant can use them on your behalf.
All requests are authenticated with your Partnero API key, so the assistant only accesses data your account is allowed to see.
***
### What your AI assistant can do
Once connected, your assistant can manage:
**Partner management**
* list, search, get partners
* create, update partners
* archive / restore partners
**Customer management**
* list, search, create customers
* update customers
* view transactions and stats
* archive / restore customers
**Transactions**
* list and retrieve transactions
* create transactions (triggers commissions)
* archive / restore transactions
**Leads**
* list and manage leads
* convert or reject leads
**Rewards & program**
* view rewards
* program overview and settings
***
### How to connect Partnero MCP to your AI assistant
#### Step 1: Get your API key
1. Log in to your Partnero dashboard
2. Go to **Integration** → **MCP** (or Settings → API)
3. Generate and copy your API key:
⚠️ Keep your API key secure, as it provides full access to your program
***
#### Step 2: Connect Partnero MCP to your AI assistant
You can find ready-to-use setup instructions and configuration snippets for each supported AI tool directly in your Partnero dashboard.
1. Go to **Integrations → MCP**
2. Choose the AI tool you want to connect (Claude Desktop, Cursor, VS Code, or Claude Code CLI)
3. Copy the configuration instructions shown for that tool:
4. In the code snippet, find the placeholder **Authorization**\*\*: Bearer YOUR\_API\_KEY\*\* and replace `YOUR_API_KEY` with your actual API key generated from your Partnero dashboard.
5. Paste them into your AI tool’s MCP or integration settings
6. Restart your AI tool if needed.
***
### Example prompts
You can ask:
* Show me my top 10 partners by performance
* How many customers were referred this month?
* Create a new partner with email [jane@example.com](mailto:jane@example.com)
* Get transaction history for customer cust\_123
* What’s the total pending commission amount?
* Search for partners named John
* Create a customer for and link to partner partner\_abc
* Give me an overview of my program
The assistant will choose the right tool and return results in natural language.
***
### Rate limits
* Tool calls: 360 requests/minute
* SSE connections: 5 per IP/minute
If you hit limits, wait a minute or batch requests.
***
### Troubleshooting
**401 Unauthorized**
* Check API key and Authorization header
**Tool not appearing**
* Restart your AI application
**429 Too Many Requests**
* Wait 60 seconds or reduce request frequency
**Local server issues**
* Ensure Node.js 18+ is installed
* Check `node --version`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.