https://partli.app/api/mcp as a remote MCP server in Claude, ChatGPT, Cursor or VS Code and sign in with your Partli account. The agent gets 56 tools: 24 read data, the rest act on it, and the 14 that move money or email people are marked so your client asks before calling them.Connection details
| VALUE | |
|---|---|
| Endpoint | https://partli.app/api/mcp |
| One workspace | https://partli.app/api/mcp/<workspace-slug> |
| Transport | Streamable HTTP (JSON-RPC 2.0) |
| Auth | OAuth 2.1 with PKCE (discovered automatically), or Authorization: Bearer pk_live_… |
| Protocol versions | 2024-11-05 to 2026-07-28 |
| Also serves | Prompts (step-by-step playbooks) and MCP Apps widgets |
| Tools | 56, each with title and read-only / destructive annotations |
Here is what the endpoint returns to a client that hasn't signed in yet. The WWW-Authenticate header is how MCP clients find the sign-in server and start OAuth on their own:
$ curl -i -X POST https://partli.app/api/mcp -d '{"jsonrpc":"2.0","id":1,"method":"initialize",…}'
HTTP/2 401
www-authenticate: Bearer resource_metadata="https://partli.app/.well-known/oauth-protected-resource/api/mcp"
{"jsonrpc":"2.0","id":null,"error":{"code":-32001,
"message":"Unauthorized — sign in via OAuth (supported MCP clients do this automatically)
or pass a Partli API key as 'Authorization: Bearer pk_live_…'."}}Install it in your client
Claude.ai and Claude Desktop
Settings → Connectors → Add custom connector. Name it Partli, paste https://partli.app/api/mcp, then click Connect and sign in. Claude Desktop uses the same connectors as your Claude.ai account.
Claude Code
claude mcp add --transport http partli https://partli.app/api/mcp
# then run /mcp, choose partli and sign inOr install the plugin, which adds the server together with the Partli skill and slash commands such as/partli:monthly-close:
/plugin marketplace add https://partli.app/marketplace.json
/plugin install partli@partliChatGPT
Settings → Connectors → create a custom connector with the URL https://partli.app/api/mcp and OAuth authentication, then sign in. Depending on your ChatGPT plan, custom connectors may first need developer mode turned on.
Cursor
// .cursor/mcp.json
{
"mcpServers": {
"partli": { "url": "https://partli.app/api/mcp" }
}
}VS Code
// .vscode/mcp.json
{
"servers": {
"partli": { "type": "http", "url": "https://partli.app/api/mcp" }
}
}Headless agents and CI (API key)
{
"mcpServers": {
"partli": {
"url": "https://partli.app/api/mcp/acme",
"headers": { "Authorization": "Bearer pk_live_..." }
}
}
}Prefer a terminal? The partli CLI exposes the same operations from the same registry. See the MCP and CLI docs.
All 56 tools
This list is generated from the server's own tool registry, so it matches what your client sees in tools/list. Asks first marks tools with MCP's destructiveHint: they move money, email real people or can't be undone.
Setup and go-live
Create the workspace and program, install tracking and prove a real sale is attributed.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
setup_status | Go-live checklist | Read only |
create_workspace | Create workspace | Changes data |
update_workspace | Update workspace name/URL | Changes data |
list_workspaces | List workspaces | Read only |
use_workspace | Switch default workspace | Changes data |
create_program | Create program | Changes data |
update_program | Update program | Changes data |
get_tracking_setup | Get tracking setup | Read only |
verify_tracking | Verify tracking install | Changes data |
verify_attribution | Verify end-to-end attribution | Read only |
set_referral_domain | Set custom referral domain | Changes data |
verify_referral_domain | Verify custom referral domain | Changes data |
get_branding | Get branding | Read only |
update_branding | Update branding | Changes data |
account_status | Account plan & usage | Read only |
Partners and applications
Review who applied, approve or reject with the full side effects, organise partners into reward groups.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
review_applications | Review partner applications | Read only |
list_partners | List partners | Read only |
get_partner | Get partner | Read only |
approve_partner | Approve partner | Changes data |
reject_partner | Reject partner | Changes data |
invite_partner | Invite partner | Asks first |
ban_partner | Ban partner | Asks first |
delete_partner | Delete partner | Asks first |
list_groups | List partner groups | Read only |
create_group | Create partner group | Changes data |
move_partner_to_group | Move partner to group | Changes data |
update_group_rewards | Set group reward rate | Changes data |
import_partners | Bulk-import partners | Asks first |
list_partner_messages | List partner messages | Read only |
message_partner | Message partner | Asks first |
Recruiting
Find creators and publishers who already reach your buyers, then invite them.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
find_affiliate_prospects | Find affiliate prospects | Changes data |
list_prospects | List prospects | Read only |
list_campaigns | List email campaigns | Read only |
send_campaign | Send email campaign | Asks first |
Sales, commissions and fraud
Report on what partners earned, fix missed referrals and check suspicious clicks.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
workspace_stats | Workspace stats | Read only |
list_customers | List referred customers | Read only |
list_commissions | List commissions | Read only |
commission_summary | Commission totals & liability | Read only |
release_commission | Release commission early | Changes data |
attribute_sale | Attribute a sale | Asks first |
list_coupon_aliases | List coupon aliases | Read only |
add_coupon_alias | Map a Stripe code to a partner | Changes data |
remove_coupon_alias | Remove coupon alias | Asks first |
list_fraud_flags | List fraud flags | Read only |
Payouts
Check the balance, then pay partners through Stripe, PayPal, Wise or bank transfer.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
payout_balance | Payout balance & readiness | Read only |
list_payouts | List payouts | Read only |
run_payouts | Run payouts | Asks first |
list_manual_payouts | List PayPal/Wise payouts owed | Read only |
send_connected_payouts | Send PayPal/Wise payouts | Asks first |
mark_manual_payouts_paid | Mark PayPal/Wise/bank payouts paid | Asks first |
send_stripe_reminders | Send Stripe-connect reminders | Asks first |
set_retainer | Set monthly retainer | Asks first |
Bounties
One-off rewards for tasks such as a review video or a launch post.
| TOOL | WHAT IT DOES | TYPE |
|---|---|---|
list_bounties | List bounties | Read only |
create_bounty | Create bounty | Changes data |
list_bounty_claims | List bounty claims | Read only |
review_bounty_claim | Review bounty claim | Asks first |
Every tool also accepts an optional workspace argument, so one connection can work across several products. This is how run_payouts describes itself to a client:
{
"name": "run_payouts",
"annotations": {
"title": "Run payouts",
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
}
}Prompts: playbooks for common jobs
The server also offers prompts. Clients that support them show these as one-click commands; in Claude Code they appear as /mcp__partli__<name>.
| PROMPT | WHAT IT DOES |
|---|---|
launch-program | Create a program, install and verify tracking, set rewards and go live. |
review-applications | Triage pending applicants with reasons, then approve or reject in one confirmed batch. |
monthly-close | Check funding, pay every rail (Stripe, PayPal, Wise, bank), record it and produce the period report. |
weekly-review | One read-only pass over performance, applicants, messages, fraud flags and bounty claims. |
migrate-partners | Import partners from Rewardful, FirstPromoter, PartnerStack, Dub or Tolt without breaking their links. |
Widgets in Claude and ChatGPT
On hosts that support MCP Apps, two tools return a small interface as well as text: review_applications shows the application queue with approve and reject buttons, and payout_balance shows payout readiness by currency. Text-only clients get the same data as structured text.
Safety
- Your permissions, nothing more. The agent acts as the account or workspace key you connect. Keys are scoped to one workspace and can be revoked at any time.
- Confirmation on money and email. 14 tools are marked destructive, and the server's instructions tell the agent to get an explicit yes before calling them.
- No bank details. Partners' payout account details are never returned to agents.
- Currencies kept apart. Totals come back grouped by currency, so an agent can't quietly add dollars to euros.
What to ask it
Our guide to running an affiliate program from Claude or ChatGPT covers the jobs worth handing to an agent, real tool output from our own workspace, and how other affiliate platforms' MCP servers compare. To find partners from chat, see recruiting affiliates with an AI agent.
FAQ
What is Partli's MCP server URL?
https://partli.app/api/mcp. It uses the Streamable HTTP transport, so any MCP client that supports remote servers can connect. To pin a connection to one product, use https://partli.app/api/mcp/<workspace-slug>.
Do I need an API key to connect?
Not for clients that support MCP's OAuth sign-in, including Claude.ai, Claude Desktop, Claude Code and Cursor: they open a Partli sign-in window the first time you use the server. Headless setups such as CI jobs or scheduled agents use a workspace API key (Dashboard → API keys) sent as a Bearer token.
Can the agent send money or email without asking?
14 of the 56 tools carry MCP's destructiveHint because they move money or email real people, such as run_payouts, send_campaign and invite_partner. Clients that respect tool annotations ask you before calling them. The server's instructions also tell the agent to show you what will happen and get an explicit yes first.
Is the MCP server included in every plan?
Yes. The MCP server and the partli CLI are included from the Starter plan up, and during the 7-day free trial.
Can one connection manage several products?
Yes. Each product is a Partli workspace. An OAuth connection can see every workspace you belong to: list_workspaces shows them, use_workspace switches the default, and every tool accepts an optional workspace argument for a one-off call. API keys are scoped to a single workspace.