com.gocushy/mcp
The checkout your AI runs — bumps, upsells, subscriptions, tax and affiliates on your own Stripe.
Open source Repository Open in the app JSON README (API)
About
The checkout your AI runs — bumps, upsells, subscriptions, tax and affiliates on your own Stripe.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- com.gocushy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.15.0
- Added
- 2026-08-29 03:01:08
- Updated
- 2026-09-13 03:08:55
- Origin id
com.gocushy/mcp
README
# gocushy MCP server
Give any AI agent the tools to run a complete selling system: products, offers
with order bumps and one-click upsells, hosted checkouts, subscriptions,
coupons, embeds, orders, refunds, affiliates, email follow-up, and sales stats
— on the merchant's own Stripe or PayPal account.
28 tools in all. Nothing is a mockup: the agent creates real checkouts that take
real money into the merchant's own account. Totals, fees, and tax are computed
server-side, so an agent can't ship a broken or mispriced checkout.
## Install
```bash
npm install -g @gocushy/mcp
```
Point your client at the `gocushy-mcp` command (stdio transport), passing the
merchant's API key:
```json
{
"mcpServers": {
"gocushy": {
"command": "gocushy-mcp",
"env": {
"GOCUSHY_API_KEY": "gc_your_key_here",
"GOCUSHY_API_URL": "https://api.gocushy.com"
}
}
}
}
```
Or run it without installing — swap the command for
`"command": "npx", "args": ["-y", "@gocushy/mcp"]`.
Then just talk: *"Set up a checkout for my $49 course, add my $17 workbook as
an order bump, and give me the embed code."*
Create an API key at <https://api.gocushy.com/signup>.
## Remote connection (ChatGPT and other hosted clients)
Prefer a URL over a local process? gocushy runs a hosted MCP endpoint. Put the
merchant's key in the path:
```
https://gocushy-mcp.fly.dev/mcp/gc_your_key_here
```
For ChatGPT connectors (which can't carry a key in the URL), connect to
`https://gocushy-mcp.fly.dev/mcp` and paste the API key on the consent screen —
the server speaks OAuth 2.0 (PKCE) for exactly this handoff.
## Tools
A representative slice — 28 in total, spanning products, offers, checkout copy
& layout, delivery, orders & sales, refunds, coupons, affiliates, email
follow-up, webhooks, and business/tax settings:
| Tool | What it does |
|---|---|
| `connect_payment` | Start Stripe onboarding (returns a URL for the human — the one manual step) |
| `connect_paypal` | Connect a PayPal account as a payment rail |
| `payment_status` | Is the account ready to take payments? |
| `create_product` | Create a sellable product (one-time or subscription) |
| `create_offer` | Compose a checkout: product + optional bump + optional one-click upsell, plus a per-offer top logo (`checkout_logo_url`) |
| `update_checkout` | Customize checkout copy, layout, the brand banner, the per-offer logo, and the one-click upsell page (headline, body, accept/decline labels) |
| `create_coupon` | A promo code buyers type at checkout — works on one-time and subscription offers |
| `get_checkout_link` | Hosted checkout URL — works immediately |
| `get_embed_code` | Copy-paste overlay snippet for any site |
| `list_orders` / `get_sales` | Orders with bump/upsell flags; revenue and per-offer breakdown |
| `refund_order` | Full or partial refund (reverses the transfer + fee) |
| `connect_email` / `set_followup` | Wire buyers into the merchant's Mailchimp / ActiveCampaign sequences |
| `create_affiliate` / `create_webhook` | Affiliate links with holdback; order webhooks for custom fulfillment |
The full tool list, with every parameter, is advertised by the server itself —
your agent discovers it on connect.
## Design principles
- **Server-side truth.** Totals, fees, tax, and state live in the API; tools
can't create a broken or mispriced checkout.
- **Fail loudly.** Validation errors come back verbatim so the agent can fix
its call and retry.
- **One human touchpoint.** Everything is agent-operable except payment-provider
KYC, which is legally the merchant's to complete.
## Development
```bash
npm install && npm run build
GOCUSHY_API_KEY=gc_... node dist/index.js # stdio transport
```