Subbly MCP server

The ecommerce MCP server built for agents

One URL gives any MCP client over 130 tools to run a Subbly store: products, plans, bundles, subscriptions, orders, customers, coupons and inventory. Streamable HTTP, your API key in a header, on every plan.

Connect your agent Get your API key

MCPhttps://mcp.subbly.dev/mcp

MCP sessionExample

initialize mcp.subbly.dev/mcp
X-API-KEY ••••••••••••••••
connected streamable HTTP
tools/list
130+ tools
list_products create_plan list_subscriptions ship_order create_coupon …
tools/call create_plan
3 months prepaid, 10% off unpublished

Every plan
Streamable HTTP
Stateless
Key in a header

Any MCP client

Connect any MCP client

If it can send a header to a remote MCP server, it can connect. These three things are all it needs.

Server URL: https://mcp.subbly.dev/mcp
Transport: Streamable HTTP
Header: X-API-KEY: your Private API key

Get your key in Settings, API keys. The tools are documented in the developer docs, with how to try them in the MCP Inspector.

Your Subbly API key Get a keyNever saved or sent

Config for most MCP clients

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

Setup guides for each agent

The exact steps for each agent, with your key filled in for you. Most take one command or one click.

Every tool your agent needs

Each tool wraps one call to Subbly’s Private API and takes the same fields. These are the 106 in the developer docs; tools that archive or delete something tell the agent to confirm with you first.

Products, variants and plans
23 tools
One-time and subscription products, their variants and plans, publish, unpublish and metadata.
- list_products
- get_product
- create_one_time_product
- update_one_time_product
- publish_one_time_product
- unpublish_one_time_product
- archive_one_time_product
- set_one_time_product_metadata
- create_subscription_product
- update_subscription_product
- publish_subscription_product
- unpublish_subscription_product
- archive_subscription_product
- set_subscription_product_metadata
- get_variant
- create_variant
- update_variant
- archive_variant
- batch_variants
- get_plan
- create_plan
- update_plan
- archive_plan
Bundles and collections
28 tools
Build-a-box bundles with their items and plans, and product collections.
- list_bundles
- get_bundle
- create_bundle
- update_bundle
- publish_bundle
- unpublish_bundle
- archive_bundle
- set_bundle_metadata
- list_bundle_groups
- list_bundle_items
- get_bundle_item
- create_bundle_item
- update_bundle_item
- delete_bundle_item
- batch_bundle_items
- get_bundle_plan
- create_bundle_plan
- update_bundle_plan
- archive_bundle_plan
- list_collections
- get_collection
- create_collection
- update_collection
- publish_collection
- unpublish_collection
- archive_collection
- list_collection_items
- batch_collection_items
Subscriptions
10 tools
Find, cancel and restore subscriptions, and change their items, preferences and bundles.
- list_subscriptions
- get_subscription
- cancel_subscription
- undo_subscription_cancellation
- create_subscription_item
- get_subscription_item
- update_subscription_item
- delete_subscription_item
- update_subscription_item_preferences
- update_subscription_item_bundle
Orders and invoices
15 tools
Ship, update, cancel or hold orders, and schedule, void, forgive or settle invoices.
- list_orders
- get_order
- update_order
- ship_order
- cancel_order
- mark_order_as_pending
- archive_order
- mark_order_as_future_shipment
- batch_order_shipping_items
- list_invoices
- get_invoice
- schedule_invoice_payment
- void_invoice
- forgive_invoice
- mark_invoice_as_paid
Customers and payments
6 tools
Customers, payment methods, transactions and the reasons subscribers give for cancelling.
- list_customers
- get_customer
- get_payment_method
- list_transactions
- get_transaction
- list_cancellation_reasons
Coupons and inventory
14 tools
Create and edit coupons, and track stock across inventory items and groups.
- list_coupons
- get_coupon
- create_coupon
- update_coupon
- archive_coupon
- list_inventory_items
- get_inventory_item
- create_inventory_item
- update_inventory_item
- archive_inventory_item
- list_inventory_groups
- get_inventory_group
- create_inventory_group
- update_inventory_group
Store data
10 tools
Metafields, tags, surveys, funnels, options and countries (funnels are read-only).
- list_metafields
- create_metafield
- update_metafield
- list_tags
- list_surveys
- get_survey
- list_funnels
- get_funnel
- list_options
- list_countries

Fields and responses for every tool, in the developer docs

Frequently asked questions

What is an ecommerce MCP server?

A server that gives AI agents tools to work on an online store through the Model Context Protocol, the open standard agents like Claude, ChatGPT and Cursor use to connect to other software. Subbly's MCP server gives them tools for products, plans, bundles, subscriptions, orders, customers, coupons and inventory.

What is the Subbly MCP server URL?

https://mcp.subbly.dev/mcp. It uses the streamable HTTP transport, and every request carries your Subbly Private API key in an X-API-KEY header.

Is the MCP server the same as Subbly's Private API?

It is built on it. Each tool wraps one Private API endpoint and takes the same fields, so the Private API reference explains what every field means and what comes back.

Does it work with clients that only run local servers?

Yes, through the mcp-remote bridge, which runs locally and connects to the remote server with your key. The Claude Desktop guide shows the config, with the version pinned.

Can I sign in instead of using an API key?

Not yet. Today every client connects with an API key. Signing in with your Subbly account, so Claude and ChatGPT can connect without a key, is coming soon.

Does the server keep any data?

No. It is stateless: each request is its own session, and it does not store your key. It creates a fresh API client for each tool call with the key that came in.

What can't it do yet?

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, or read analytics reports. Agents can pull the raw orders and subscriptions and work out the numbers.

Which Subbly plans include the MCP server?

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

Is it safe to give an AI agent 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. Most agents ask 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.

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

About us

API docs New

Agency program New

Facebook group

Blog

Subbly University

Support center

Subscription Resources

The ecommerce MCP server built for agents

Connect any MCP client

Setup guides for each agent

Every tool your agent needs

Products, variants and plans

Bundles and collections

Subscriptions

Orders and invoices

Customers and payments

Coupons and inventory

Store data

Frequently asked questions

More from Subbly Answers

Give your agent a store worth running

About Subbly

Subscription-first

Community

Resources

Help & Support

More Info