CursorSubbly MCP

Run your Subbly store from Cursor

One entry in Cursor's MCP config connects its agent to Subbly. It can then manage your products, plans, subscriptions, orders and coupons, and build against your real store data.

Set up Cursor Start for free

3 days free, then $1/wk for 2 weeksNo card needed

MCPhttps://mcp.subbly.dev/mcp

pricing.tsx · CursorExample

Use my real Subbly plans on the pricing section.

subbly · list_products

subbly · get_plan

Updated pricing.tsx with your 3 live plans. Prices now come from Subbly.

Ask Cursor

Set up Subbly’s MCP server in Cursor

Pick your agent. Each one connects to the same server, in its own way.

Your API key

Used only to fill in the steps on this page. Never saved or sent anywhere. Get a key

Fastest

Add Subbly to Cursor in one click

Paste your key above, then click. Cursor opens with Subbly filled in and asks you to confirm.

Add to CursorPaste your key above to turn this on.

Or by hand

Add it to Cursor's MCP config

Get your API key
In your Subbly admin, open Settings, then API keys, and generate a Private API key for Cursor.

Add Subbly to mcp.json

This file covers every project. For one project only, use .cursor/mcp.json in its folder.

~/.cursor/mcp.json

json

{
  "mcpServers": {
    "subbly": {
      "url": "https://mcp.subbly.dev/mcp",
      "headers": {
        "X-API-KEY": "YOUR_SUBBLY_API_KEY"
      }
    }
  }
}

Switch it on
Open Cursor's settings, find MCP and make sure subbly is on. Its tools are listed under it.

Check it worked. In Cursor's MCP settings, subbly shows as on with its tools listed. Then ask the agent to list your published products.

Why connect Cursor to Subbly

One click to set up
The Add to Cursor button fills in Subbly's server and your key, and Cursor asks you to confirm.
Real store data in your editor
Cursor's agent reads your products and plans while it writes your storefront, so the site always shows what you sell.
Change the store without leaving the code
Add a plan, publish a product or create a coupon from the agent panel while you build.

Try these with Cursor

Once Subbly is connected, just describe what you want. Copy one to start, or use it as a starting point.

01
Keep pricing in sync
Use my real Subbly plans on the pricing section of this site, and load them from Subbly so the prices never go out of date.
02
Check the connection
List my published Subbly products with their prices.
03
Understand churn
Which Subbly subscriptions were cancelled in the last 30 days? Group them by cancellation reason and tell me what stands out.
04
Add a plan
Add a 3-month prepaid plan to my best-selling subscription, priced 10% below three monthly payments. Leave it unpublished so I can review it.
05
Run a promotion
Create a coupon called WELCOME15 for 15% off a customer's first order. Show me the settings before you save it.
06
Clear the shipping queue
Show me every order that is waiting to ship, oldest first, and flag any that have waited more than 3 days.

Cursor runs the store. Your Subbly agent builds the site.

The MCP server gives Cursor 130+ tools for every ecommerce need. Each one is a call to Subbly’s API, so what it changes is real, and you see it in your admin straight away.

Products and plans
Create products, variants and plans, then publish when you're ready.
House blend subscription
From $24 a month
- Monthly
- Every 2 weeks
- 3 months prepaid, 10% off
get_productcreate_plan
Subscriptions
Find, cancel or restore them, and change what's in the box.
- Ava ThompsonMonthlyActive
- Leo MartinEvery 2 weeksPaused
- Priya ShahPrepaidActive
list_subscriptionscancel_subscription
Orders and shipping
Clear the queue, mark shipments and hold orders for later.
- #1042House blend, 2 bagsShipped
- #1043Gift boxShipped
- #1044Decaf, 1 bagShip
list_ordersship_order
Coupons and customers
Create offers, and look up customers, payments and invoices.
WELCOME15
15% off a first order
15%off
create_couponget_customer
Bundles and stock
Build-a-box bundles, collections and inventory across groups.
Trail box, pick 438 in stock
create_bundle_itemupdate_inventory_item

See every tool in the developer docs

Built by Subbly

Describe your store. Your Subbly agent builds it.

Your website, checkout and customer portal are designed and built by your Subbly agent, around your brand. Site editing through MCP is coming soon, so the agent you already use will be able to change your pages too.

See what it builds

Not through MCP yet

Coming soon

Design or edit your website (your Subbly agent does that, and site editing through MCP is coming soon)
Set up funnels, automations, dunning or the referral program
Read analytics reports (it can pull the raw orders and subscriptions to work them out)

You set those up in your Subbly admin.

Frequently asked questions

Where do I find my Subbly API key for Cursor?

In your Subbly admin, open Settings, then API keys (https://www.subbly.co/admin/settings/api-keys). In the Private API keys card, choose Generate API key and copy it. Only the store owner and admins can create keys, and Subbly asks for two-factor authentication first. Give Cursor its own key, so you can delete it without breaking anything else.

Can I keep my key out of mcp.json?

Yes. Write "X-API-KEY": "${env:SUBBLY_API_KEY}" and set SUBBLY_API_KEY in your shell profile. Restart Cursor after changing your profile so it picks the variable up.

Cursor doesn't show the Subbly tools. What should I check?

Check subbly is switched on in Cursor's MCP settings, and open the MCP Logs in the Output panel for the error. Most problems are a key with a space or line break at the end, or invalid JSON in mcp.json.

Is it safe to give Cursor my Subbly API key?

The key can read and change everything in your store, so treat it like a password and keep it out of files you share or commit. Cursor asks before running a tool unless you allow it, and Subbly's tools tell the agent to confirm with you before archiving or deleting anything. If a key leaks, delete it under Settings, API keys, and it stops working straight away.

Can Cursor build my website through Subbly's MCP server?

Not yet. The MCP server runs your store: products, plans, subscriptions, orders, customers and coupons. Your website is built by your Subbly agent: describe it in Subbly and it designs and builds the store, checkout included. Site editing through MCP is coming soon, so Cursor will be able to change your pages too. Until then, Cursor can build a custom storefront in code that checks out with the SubblyCart.js widget.

Which Subbly plans work with Cursor?

Every plan includes the MCP server, with usage limits that depend on your plan.

Using a different agent?

Give your agent a store worth running

Your Subbly agent builds a store that looks like your brand. Your own agent runs it. No plugins, no developers, no lock-in.

Start for free

3 days free, then $1/wk for 2 weeksNo card needed

Run your Subbly store from Cursor

Set up Subbly’s MCP server in Cursor

Add Subbly to Cursor in one click

Add it to Cursor's MCP config

Get your API key

Add Subbly to mcp.json

Switch it on

Why connect Cursor to Subbly

One click to set up

Real store data in your editor

Change the store without leaving the code

Try these with Cursor

Keep pricing in sync

Check the connection

Understand churn

Add a plan

Run a promotion

Clear the shipping queue

Cursor runs the store. Your Subbly agent builds the site.

Products and plans

Subscriptions

Orders and shipping

Coupons and customers

Bundles and stock

Describe your store. Your Subbly agent builds it.

Not through MCP yet

Frequently asked questions

More from Subbly Answers

Using a different agent?

Give your agent a store worth running

About Subbly

Subscription-first

Community

Resources

Help & Support

More Info