ProAbono MCP server
27 operations0 webhooks
Subscription billing API for managing customers, offers, subscriptions, usages, balance lines and invoices.
Try ProAbono with your agent
Connect ProAbono, 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 ProAbono on my account, then run one read-only example and show me the result.
ProAbono tools and triggers
Tools are what your agent can do in ProAbono through Corsair's MCP server. Triggers are the ProAbono events a routine can start from.
Subscriptions
- CreateDestructive
Subscribe a customer to an offer, which starts billing when the offer is paid and the customer is billable. `TryStart: false` creates it without starting so it can be customised first
subscriptions.create
- GetRead-only
Read one subscription with its state, period, next billing date and features. The docs warn against using this to check whether a user is a subscriber
subscriptions.get
- ListRead-only
List subscriptions filtered by customer, offer or segment, one page at a time
subscriptions.list
- StartDestructive
Start a subscription that was created without starting, which begins billing
subscriptions.start
- SuspendWrite
Suspend a subscription without terminating it
subscriptions.suspend
- TerminateDestructive
Terminate a subscription, ending it for good; by default at the end of the current period. A later start cannot revive it
subscriptions.terminate
- Update TermWrite
Change a subscription's end date
subscriptions.updateTerm
- UpgradeDestructive
Move a subscription to another offer, which changes what it bills from the next period
subscriptions.upgrade
Customers
- AnonymizeDestructive
Erase a customer's personal data. This cannot be undone, and ProAbono keeps the billing record only as it must
customers.anonymize
- CreateWrite
Create a customer with your own reference, which subscriptions and usages then identify it by
customers.create
- GetRead-only
Read one customer by your reference, with whether it is billable
customers.get
- InvalidateDestructive
Invalidate a customer: ProAbono replaces their reference so it can be reused and revokes their portal links. Subscriptions, invoices and payment methods stay
customers.invalidate
- ListRead-only
List the customers in a segment, one page at a time
customers.list
- SuspendWrite
Suspend a customer without deleting anything, so they can be reactivated
customers.suspend
- UpdateWrite
Change a customer's name, email, language, affiliation or metadata. ProAbono creates and updates on the same route, so an unknown reference creates a customer
customers.update
Usages
- GetRead-only
Read one customer's usage of one feature: on/off, or the included and current quantities
usages.get
- IncrementDestructive
Add to a feature’s usage for a customer, which ProAbono bills when it exceeds the included quantity. A negative increment subtracts, which is how a reversed action is recorded
usages.increment
- ListRead-only
List feature usages by customer, feature or subscription, one page at a time
usages.list
- UpdateDestructive
Update up to 50 usages in one call, each by increment, current quantity or on/off
usages.update
Balance Lines
- CreateDestructive
Add a balance line, such as a one-off charge or credit in cents, to a customer's next invoice
balanceLines.create
- ListRead-only
List balance lines by customer, segment, feature or subscription, with their totals
balanceLines.list
Features
- GetRead-only
Read one feature by its reference
features.get
- ListRead-only
List the features your offers carry
features.list
Invoices
- GetRead-only
Read one invoice with its totals and links
invoices.get
- ListRead-only
List invoices by customer or subscription, one page at a time
invoices.list
Offers
- GetRead-only
Read one offer by its reference
offers.get
- ListRead-only
List the offers in a segment, optionally in a customer language and with their upgrade links
offers.list
Connect ProAbono to Claude, ChatGPT or Cursor
- 1
Connect ProAbono in Corsair
Add your ProAbono API key once in Corsair. Corsair stores the credential encrypted and makes the ProAbono API calls for your agent, so it never goes into a prompt or a config file. Connect ProAbono
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs ProAbono. On a ChatGPT personal plan, connect ProAbono 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, ProAbono's read and write operations run right away and its 9 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/proabono, add the ProAbono plugin, and connect with an API key. Then call methods like corsair.proabono.api.balanceLines.create() from your app. Corsair keeps each tenant isolated.
Yes. ProAbono requires an API key from your ProAbono 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 ProAbono, GitHub, Notion, Stripe, and the rest. Trigger ProAbono from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for subscription billing API for managing customers, offers, subscriptions, usages, balance lines and invoices. Common builds include sync jobs, admin tooling, and agents that call ProAbono 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 ProAbono 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/proabono in the open repo. When ProAbono 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 ProAbono data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store ProAbono 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 ProAbono 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 9 destructive ProAbono operations. You can change a link's mode at hub.corsair.dev/me.