Skip to main content
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 — Anthropic’s desktop application
  • Cursor — AI-powered code editor
  • 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

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 settings

​
Setup

1

Get Your API Key

  1. Log in to Partnero
  2. Go to Integration → MCP
  3. Generate and copy your API key
Keep your API key secure—it provides full access to your program data.
2

Configure Your AI Tool

Choose your AI tool and add the configuration below. Replace YOUR_API_KEY with your actual API key.
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"
      ]
    }
  }
}
3

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:
  • “Show me my top 10 partners by performance”
  • “Create a new partner with email [email protected]”
  • “Search for partners named John”
  • “Archive partner partner_abc”
  • “How many customers were referred this month?”
  • “Create a customer for [email protected] and link them to partner partner_abc”
  • “Get details for customer cust_123”
  • “Get transaction history for customer cust_123”
  • “What’s the total pending commission amount?”
  • “Show me all transactions from last week”
  • “Give me an overview of my program”
  • “What are my current commission rates?”
  • “Show me program statistics”

​
Rate Limits

ResourceLimit
Tool calls360 requests/minute
SSE connections5 per IP/minute
If you hit rate limits, wait a minute before retrying or batch your requests.

​
Troubleshooting

  • 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
  • Restart your AI application completely
  • Verify the MCP configuration file is in the correct location
  • Check for JSON syntax errors in your configuration
  • Wait 60 seconds before making more requests
  • Reduce request frequency
  • Batch multiple operations into single requests when possible
  • 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