Tapfiliate MCP server
41 operations0 webhooks
Affiliate and partner program management with Tapfiliate - create and list affiliates, add them to programs and approve them, track conversions and customers, approve or disapprove commissions, and record payments.
Try Tapfiliate with your agent
Connect Tapfiliate, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Tapfiliate on my account, then run one read-only example and show me the result.
Tapfiliate tools and triggers
Tools are what your agent can do in Tapfiliate through Corsair's MCP server. Triggers are the Tapfiliate events a routine can start from.
Affiliates
- BalancesRead-only
Read one affiliate's balance per currency
affiliates.balances
- CreateWrite
Create an affiliate and run the Affiliate created triggers; the new affiliate joins no program until you add it to one
affiliates.create
- Custom FieldsRead-only
List the custom fields on your signup form, whose IDs affiliate creates take
affiliates.customFields
- DeleteDestructive
Permanently delete an affiliate; their personal data is cleared and the record is locked
affiliates.delete
- GetRead-only
Read one affiliate with their company, address, custom fields and metadata
affiliates.get
- ListRead-only
List affiliates, newest first, 25 per page, filtered by email, referral code, click, parent or group
affiliates.list
- PaymentsRead-only
List one affiliate's payments, newest first
affiliates.payments
- ProgramsRead-only
List the programs an affiliate belongs to, with the coupon, approval state and referral link for each
affiliates.programs
Programs
- Add AffiliateDestructive
Add an existing affiliate to a program, approved by default (which sends the approval email when the program notifies on approval), or pending or disapproved explicitly
programs.addAffiliate
- AffiliatesRead-only
List a program's affiliates in every approval state, with each one's coupon and referral link
programs.affiliates
- Approve AffiliateDestructive
Approve an affiliate for a program and email them when the program notifies on approval
programs.approveAffiliate
- Disapprove AffiliateWrite
Disapprove an affiliate for a program; they keep the record but earn nothing there
programs.disapproveAffiliate
- GetRead-only
Read one program, including an archived one, with its currency, cookie time and status
programs.get
- Get AffiliateRead-only
Read one affiliate within a program, with their program-specific coupon and approval state
programs.getAffiliate
- ListRead-only
List your programs, archived ones included, 25 per page
programs.list
- Update AffiliateWrite
Change an affiliate's coupon in a program; null removes it and omitting it changes nothing
programs.updateAffiliate
Customers
- CancelWrite
Cancel a customer, which stops its automatic recurring commissions; another call can reactivate it
customers.cancel
- CreateWrite
Create a customer attributed to an affiliate; no commission is created until a conversion arrives
customers.create
- DeleteDestructive
Permanently delete a customer and its metadata; its conversions and commissions stay but lose the link
customers.delete
- GetRead-only
Read one customer with the click it was tracked from and its current fraud warnings
customers.get
- ListRead-only
List customers, newest first, filtered by program, customer ID, affiliate or date range
customers.list
- UncancelWrite
Reactivate a canceled customer, restoring recurring commissions from now without back-filling
customers.uncancel
- UpdateWrite
Change a customer's customer_id or replace its metadata
customers.update
Commissions
- ApproveDestructive
Approve a commission, also when it was disapproved before, and fire the commission triggers
commissions.approve
- DisapproveDestructive
Disapprove a commission from pending or approved, which removes it from the affiliate balance
commissions.disapprove
- GetRead-only
Read one commission of any kind: regular, recurring, MLM level or bonus
commissions.get
- ListRead-only
List commissions, filtered by affiliate, status or whether they are paid
commissions.list
- UpdateDestructive
Change a commission's amount or comment
commissions.update
Conversions
- CreateDestructive
Track a conversion and create its commissions, attributed through a coupon, click, referral code, asset or tracking ID
conversions.create
- DeleteDestructive
Permanently delete a conversion with all of its commissions and metadata
conversions.delete
- GetRead-only
Read one conversion with every commission, including MLM levels, and its fraud warnings
conversions.get
- ListRead-only
List conversions with their commissions, newest first, filtered by program, affiliate, external ID or date
conversions.list
- UpdateDestructive
Change a conversion's amount, external ID or metadata; commissions change only with recalculate_commissions and a numeric amount
conversions.update
Payments
- CancelDestructive
Cancel a payment. It stops counting against the affiliate balance, so the balance goes back up by its amount; an outside payout already sent is not reversed, and there is no undo
payments.cancel
- CreateDestructive
Record one payment or an array of payments; an affiliate on an automated payout method is also paid out through that provider. Tapfiliate creates none when any entry is invalid
payments.create
- GetRead-only
Read one payment with its affiliate, amount and currency
payments.get
- ListRead-only
List payments that were not canceled, newest first
payments.list
Clicks
- CreateWrite
Record a click and return its ID for use as click_id when creating a conversion
clicks.create
- GetRead-only
Read one click with its device details, country and metadata, plus its affiliate and program
clicks.get
- ListRead-only
List clicks on your programs, filtered by program, affiliate or date; needs the click-report feature on your plan
clicks.list
Balances
- ListRead-only
List what you owe each affiliate with a non-zero balance, per currency
balances.list
Connect Tapfiliate to Claude, ChatGPT or Cursor
- 1
Connect Tapfiliate in Corsair
Add your Tapfiliate API key once in Corsair. Corsair stores the credential encrypted and makes the Tapfiliate API calls for your agent, so it never goes into a prompt or a config file. Connect Tapfiliate
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Tapfiliate. On a ChatGPT personal plan, connect Tapfiliate here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Tapfiliate's read and write operations run right away and its 12 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/tapfiliate, add the Tapfiliate plugin, and connect with an API key. Then call methods like corsair.tapfiliate.api.affiliates.balances() from your app. Corsair keeps each tenant isolated.
Yes. Tapfiliate requires an API key from your Tapfiliate account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Tapfiliate, GitHub, Notion, Stripe, and the rest. Trigger Tapfiliate from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for affiliate and partner program management with Tapfiliate - create and list affiliates, add them to programs and approve them, track conversions and customers, approve or disapprove commissions, and record payments. Common builds include sync jobs, admin tooling, and agents that call Tapfiliate APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Tapfiliate API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/tapfiliate in the open repo. When Tapfiliate ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Tapfiliate data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Tapfiliate data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Tapfiliate on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 12 destructive Tapfiliate operations. You can change a link's mode at hub.corsair.dev/me.