ClaudeSubbly MCP

Run your Subbly store from Claude

Connect Subbly to Claude and ask about your store in plain English: find subscriptions, ship orders, add plans and coupons, and turn your store's data into dashboards and plans you can share.

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

MCPhttps://mcp.subbly.dev/mcp
ClaudeExample

Make me a dashboard of my subscribers by plan.

subbly · list_subscriptions

Here's your dashboard: 412 active subscribers across 3 plans. Monthly is 61% of them.

Ask Claude

Set up Subbly’s MCP server in Claude

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

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

Fastest

Add Subbly as a custom connector

One connector works in Claude on the web, Desktop and mobile, and in Cowork. It needs request headers, a beta Anthropic is rolling out to more accounts.

  1. Open Connectors and add a custom connector

    In Claude, open Customize, then Connectors, and choose Add custom connector. On a Team or Enterprise plan, an owner adds it under Organization settings, Connectors.

  2. Name it Subbly and paste the server URL

    Server URL
    https://mcp.subbly.dev/mcp
  3. Choose No sign-in, then add your key as a request header

    Under Request headers, add X-API-KEY with your key as the value. No Request headers section? Your account doesn't have the beta yet, so use Claude Desktop's config file below.

    Request header
    X-API-KEY: YOUR_SUBBLY_API_KEY

Or use Claude Desktop's config file

Claude Desktop starts local programs from its config file, so a small bridge (mcp-remote) carries your key to Subbly's server.

  1. Install Node.js 18 or later

    The bridge runs with npx, which comes with Node.js (nodejs.org).

  2. Open the config file

    In Claude Desktop, open Settings, then Developer, and choose Edit Config. Merge this into mcpServers, keeping any servers already there.

    ~/Library/Application Support/Claude/claude_desktop_config.json

    json
    {
      "mcpServers": {
        "subbly": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote@0.1.38",
            "https://mcp.subbly.dev/mcp",
            "--transport",
            "http-only",
            "--header",
            "X-API-KEY:${SUBBLY_API_KEY}"
          ],
          "env": {
            "SUBBLY_API_KEY": "YOUR_SUBBLY_API_KEY"
          }
        }
      }
    }
  3. Restart Claude Desktop

    Quit it fully, then reopen it. Subbly shows in a chat's + menu, under Connectors.

Check it worked. In a new chat, ask Claude to list your published Subbly products. It asks to use the Subbly tool the first time.

Why connect Claude to Subbly

  • Turn store data into artifacts

    Ask for a subscriber dashboard, a launch plan or a packing sheet, and Claude builds it from your real Subbly data as an artifact you can share.

  • Ask about your store in plain English

    Find a subscription, check what's waiting to ship or see why people cancel, without opening the admin.

  • One connector across Claude's apps

    Add Subbly once and use it in Claude on the web, Desktop and mobile, and in Cowork.

Try these with Claude

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

  1. 01

    Check the connection

    List my published Subbly products with their prices.

  2. 02

    Understand churn

    Which Subbly subscriptions were cancelled in the last 30 days? Group them by cancellation reason and tell me what stands out.

  3. 03

    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.

  4. 04

    Run a promotion

    Create a coupon called WELCOME15 for 15% off a customer's first order. Show me the settings before you save it.

  5. 05

    Subscriber dashboard

    Pull my active Subbly subscriptions and build an interactive dashboard: subscribers by plan, new this month, and cancellations by reason.

  6. 06

    Launch plan

    Read my Subbly products and plans, then write a launch plan for a new seasonal box: the product, the plans, a coupon and the dates, as a document I can share.

  7. 07

    Packing sheet

    List this week's orders waiting to ship and make a printable packing sheet grouped by product.

Artifacts

Turn your store into dashboards, plans and documents

Agents that make artifacts, like Claude, work between your store and everything else. They pull the real numbers from Subbly and turn them into something you can share, print or act on.

Pull my active Subbly subscriptions and build an interactive dashboard: subscribers by plan, new this month, and cancellations by reason.

Subscriber dashboardArtifact

Active subscribers

412

New this month

38

Cancelled this month

11

Subscribers by plan

  • Monthly251
  • Every 2 weeks97
  • 3 months prepaid64

Monthly is 61% of your subscribers. Most cancellations this month said they had too much coffee.

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

The MCP server gives Claude 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.

    Four bags of coffee on a barrel

    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.

    An outdoor kit: a backpack, a flask, a first aid pouch and trail snacks

    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 Claude?

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

Is Claude the same as Claude Code or Cowork?

They're all made by Anthropic. Claude is the chat app on the web, desktop and mobile. Cowork is Claude Desktop's agent for longer tasks on your files, and it uses the same connectors as Claude. Claude Code is the coding agent for your terminal and IDE, with its own MCP setup.

Why can't I see Request headers when I add the connector?

Sending a key in a request header is a beta that Anthropic is rolling out to more accounts. Until your account has it, use Claude Desktop's config file, which works on every plan.

Can Claude make dashboards and documents from my store data?

Yes. Ask Claude to pull your subscriptions, orders or products from Subbly and it can turn them into an artifact: an interactive dashboard, a launch plan or a printable packing sheet. Artifacts update when you ask again, so you can rerun them with fresh data.

Does the Claude Desktop config need the mcp-remote bridge?

Yes. Claude Desktop's config file starts local programs, and Subbly's server is remote, so mcp-remote connects the two and sends your key. We pin the version so it can't change under you.

Is it safe to give Claude 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. Claude 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 Claude 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 Claude will be able to change your pages too.

Which Subbly plans work with Claude?

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

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