SamCart MCP : SamCart Knowledge Base

Connect your SamCart marketplace to Claude, ChatGPT, and other AI clients to ask questions about your sales, orders, and subscriptions without leaving the tools you already work in.

The Model Context Protocol (MCP) is a standard that lets AI models and agents connect to external tools and data. SamCart's official MCP server gives any compatible AI client secure, authenticated access to your marketplace data, so you can pull sales summaries, look up an order, or check on subscription renewals by asking a question in plain language.

Once your client is connected, it can read directly from your marketplace. That means no exporting reports, no copying data between tabs, and no waiting on a dashboard to load. You ask, and your client answers using your live SamCart data.

The MCP server is available on all SamCart plans.

NOTE: Access to the SamCart MCP server is currently read-only. Your AI client can read your marketplace data but cannot create, edit, or delete anything. Write access is on the way.

What You Can Ask For

The server exposes tools across eight areas of your marketplace. Your AI client picks the right tool automatically based on what you ask it.

Tool	What It Returns
Sales	Daily gross sales, net revenue, orders, refunds, AOV, conversion rate, visitors, and one-time/recurring breakdowns for a date range.
Orders	Orders, totals, line items, and customer details. Filter by status, product, customer, coupon, or date.
Products	Product catalog, prices, subscription terms, category, URLs, and archive status.
Subscriptions	Subscription status, billing details, renewals, and scheduled cancellations.
Refunds	Refund amounts with related order, charge, and customer context.
Customers	Customer records, addresses, and payment methods, searchable by email or phone.
Coupons	Coupon definitions, discounts, and usage data, filterable by code or product.
Upsells	Views, purchases, declines, abandonment, revenue, and take rate for order bumps, upsells, and cross-sells.

Server Details

Most clients only need two pieces of information to connect:

Server URL

https://mcp.samcart.com

Transport

Streamable HTTP

Authentication happens in your browser. When you connect, your client sends you to SamCart to log in and choose which marketplace the client should have access to. Your SamCart credentials are never stored in the client.

Setting Up Your Client

We have tested the SamCart MCP server with the clients below. Any other MCP-compatible tool should connect the same way. Jump to the Other MCP Clients section if yours is not listed here.

Claude Desktop

Open your Claude settings and navigate to Settings > Customize > Connectors. Click Add and select Custom Connector.

In the Add custom connector window, enter a name for the connector and the SamCart server URL:

Name: SamCart
URL: https://mcp.samcart.com

Click Continue. SamCart will appear in your connectors list with a Connect button next to it.

Click Connect. You will be taken to SamCart in your browser to log in and select the marketplace you want the client to access. Once you have selected a marketplace, you are done.

Claude Web

Open your Claude settings and navigate to Settings > Connectors. Click Add and select Custom Connector.

In the Add custom connector window, enter a name for the connector and the SamCart server URL:

Name: SamCart
URL: https://mcp.samcart.com

Click Continue, then click Connect next to the new SamCart entry in your connectors list. You will be taken to SamCart in your browser to log in and select the marketplace you want the client to access.

Claude Code

Run the following in your terminal:

claude mcp add samcart --transport http https://mcp.samcart.com/ -s user

The -s user flag makes the server available in every project on your machine. Open a Claude Code session and run /mcp to go through the authentication flow.

ChatGPT Desktop App

Navigate to Settings > Plugins > MCPs and click Add MCP server. Enter the following details:

URL: https://mcp.samcart.com
Type: Streamable HTTP

Click Add to save the server, then click Authenticate. You will be taken to SamCart to log in and select the marketplace you want to connect to.

ChatGPT CLI

Run the following in your terminal:

codex mcp add samcart --url https://mcp.samcart.com

You will be prompted to log in to SamCart and select a marketplace.

You can also add the server to your ~/.codex/config.toml file instead:

[mcp_servers.samcart]
url = "https://mcp.samcart.com"

Then run codex mcp login samcart to authenticate.

Other MCP Clients

Any client that supports remote MCP servers over Streamable HTTP can connect using the server URL above. Most clients ask for a name, the URL, and the transport type, then hand off to your browser for authentication.

If your client only supports local (stdio) servers, you can bridge to the remote server using mcp-remote:

{
  "mcpServers": {
    "samcart": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.samcart.com"]
    }
  }
}

Example Prompts

Once you are connected, try asking your client:

Summarize my sales for the last 30 days and compare them to the previous 30 days.
Which products drove the most revenue last month, and how much of it was recurring?
List every subscription with a scheduled cancellation in the next 30 days.
What is the take rate on my order bumps, and which one is underperforming?
Find all orders for the customer with this email address and tell me what they have bought.
How much did I refund last quarter, and which products did the refunds come from?

Troubleshooting

The client connected but no tools are available

Check that authentication completed and that you selected a marketplace. Disconnecting and reconnecting the server from your client's MCP settings resolves most connection issues.

You need to switch marketplaces

Disconnect the server in your client, then reconnect and choose a different marketplace during authentication.

Your client cannot add the server

Confirm that it supports remote MCP servers over Streamable HTTP. If it only supports local stdio servers, use the mcp-remote bridge described in the Other MCP Clients section.

A tool will not write or update anything

That is expected. The SamCart MCP server is read-only for now.

Frequently Asked Questions

Q: Can my AI client change anything in my marketplace?

A: No. The SamCart MCP server is read-only, so your client can look up and summarize your data but cannot create, edit, refund, or delete anything. Write access is planned for a future release.

Q: Which SamCart plans include MCP server access?

A: All of them. If your plan includes API access, you have access to the MCP server as well.

Q: Are my SamCart login credentials stored in the AI client?

A: No. Authentication happens in your browser through SamCart, and your credentials are never passed to or stored in the client.

Q: Can I connect more than one marketplace?

A: Each connection is tied to the single marketplace you select during authentication. To point your client at a different marketplace, disconnect the server in your client, then reconnect and choose the marketplace you want.

Q: My client is not in the list above. Will it still work?

A: Most likely, yes. Any client that supports remote MCP servers over Streamable HTTP can connect using the server URL. If your client only supports local stdio servers, use the mcp-remote bridge in the Other MCP Clients section. If you run into trouble with a client that is not listed, let our support team know so we can add it to this article.

Q: Does connecting an AI client slow down or affect my checkout pages?

A: No. The MCP server only reads your marketplace data. It has no effect on your checkout pages, your customers, or how orders are processed.