CodexSubbly MCP

Run your Subbly store from Codex

Three lines in your Codex config connect it to Subbly. Codex can then manage your products, plans, subscriptions, orders and coupons, and build on your real store data.

Set up Codex Start for free

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

MCPhttps://mcp.subbly.dev/mcp

~/store · CodexExample

Add a 3-month prepaid plan to the coffee subscription, 10% off.

subbly · get_product

subbly · create_plan

Added Every 3 months, prepaid at $72.90. It's unpublished until you say so.

Set up Subbly’s MCP server in Codex

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 it with one command

Run this in a terminal. It adds Subbly to the config file the Codex CLI, IDE extension and desktop app share.

Get your API key
In your Subbly admin, open Settings, then API keys, and generate a Private API key. Paste it in the key field above to fill in the command.

Add the server

Terminal

mkdir -p ~/.codex && cat >> ~/.codex/config.toml <<'EOF'

[mcp_servers.subbly]
url = "https://mcp.subbly.dev/mcp"
http_headers = { "X-API-KEY" = "YOUR_SUBBLY_API_KEY" }
EOF

3
Restart Codex and check the connection
bash
codex mcp list

Or edit the config file

The Codex CLI, the IDE extension and the desktop app share one config file.

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

Add the server to your config

Create the file if it doesn't exist.

~/.codex/config.toml

toml

[mcp_servers.subbly]
url = "https://mcp.subbly.dev/mcp"
http_headers = { "X-API-KEY" = "YOUR_SUBBLY_API_KEY" }

3
Restart Codex and check the connection
bash
codex mcp list

Keep the key out of the file

Codex can read the key from an environment variable instead, so the config file holds no secret.

Point the header at a variable

~/.codex/config.toml

toml

[mcp_servers.subbly]
url = "https://mcp.subbly.dev/mcp"
env_http_headers = { "X-API-KEY" = "SUBBLY_API_KEY" }

Set the variable, then start Codex

bash

export SUBBLY_API_KEY="YOUR_SUBBLY_API_KEY"
codex mcp list

Check it worked. Run codex mcp list and look for subbly, or type /mcp inside Codex. Then ask it to list your published products.

Why connect Codex to Subbly

Same setup in the CLI, IDE and app
Codex keeps one config for the CLI, the IDE extension and the desktop app, so Subbly is everywhere you use Codex.
Build against live store data
Codex reads your real plans and products while it builds your storefront or scripts, so prices and plans never drift.
Automate with codex exec
Run a Subbly prompt from a script or a scheduled job, like a morning check of orders that have waited too long to ship.

Try these with Codex

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

01
Morning check
Write a script I can run every morning with codex exec that lists Subbly orders waiting to ship for more than two days, oldest first.
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.

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

The MCP server gives Codex 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 Codex?

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 Codex its own key, so you can delete it without breaking anything else.

Is Codex the same as ChatGPT?

Both are made by OpenAI and sign in with your ChatGPT account. Codex is the coding agent (a CLI, an IDE extension and a desktop app) and it reads MCP servers from ~/.codex/config.toml. The ChatGPT desktop app reads the same file, so one setup covers both.

Why doesn't codex mcp add work with an API key?

codex mcp add sets up servers that sign in with OAuth. Subbly's server takes your API key in a header, which goes in config.toml as http_headers (or env_http_headers to read it from a variable).

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

Restart Codex: it reads the config when it starts. Check the file is ~/.codex/config.toml and the section is [mcp_servers.subbly]. If you used env_http_headers, start Codex from a terminal where SUBBLY_API_KEY is set.

Is it safe to give Codex 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. Codex 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 Codex 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 Codex will be able to change your pages too. Until then, Codex can build a custom storefront in code that checks out with the SubblyCart.js widget.

Which Subbly plans work with Codex?

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 Codex

Set up Subbly’s MCP server in Codex

Add it with one command

Get your API key

Add the server

Restart Codex and check the connection

Or edit the config file

Get your API key

Add the server to your config

Restart Codex and check the connection

Keep the key out of the file

Point the header at a variable

Set the variable, then start Codex

Why connect Codex to Subbly

Same setup in the CLI, IDE and app

Build against live store data

Automate with codex exec

Try these with Codex

Morning check

Check the connection

Understand churn

Add a plan

Run a promotion

Clear the shipping queue

Codex 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