Storefront MCP

Storefront MCP lets you ask an AI tool you already use, such as Claude or ChatGPT, questions about your store in plain language. The AI looks up your live Storefront data and answers, so you don't have to click through Storefront Manager page by page.

What you can do

  • Check on your store: "Which domains expire in the next 30 days, and which have auto-renew turned off?"
  • Understand your performance: "How much did I earn last month compared with the month before?"
  • Find out what went wrong: "Why did the most recent transfer order for example.com fail?"
  • Spot billing problems: "List my past-due subscriptions with customer name and amount."
  • Review your setup: "What is my default TLD markup, and what about .com specifically?"

Your AI tool decides when to look up store data, so you don't need to tell it which data to use. It works from the data as it is at the moment of the request.

📘

Storefront MCP is read-only

Your AI tool can look at your store but can't create, change, renew, refund or delete anything. It can only see your own store. If you ask it to make a change, it can tell you where to do it in Storefront Manager.

What you need

  • An account with an AI tool that supports MCP (Model Context Protocol).
  • Your Storefront Manager login. You use it once to approve the connection.

Connect your AI tool

Copy the MCP server URL

  1. In Storefront Manager, go to Settings → Developer Settings → Storefront MCP.
  2. Under MCP Server URL, click Copy.

Connection Status shows Not yet connected until you finish the steps below.

Add the URL to your AI tool

  1. In your AI tool, open the settings where you add MCP servers. Different tools name this differently, for example connectors, integrations or MCP servers.
  2. Add a new server and paste the URL you copied. Give it a name you'll recognize, such as "Storefront".
  3. Start the connection. Your AI tool opens a Storefront page in your browser.

For help with these steps in your AI tool, see its own documentation:

Approve the connection

  1. If you're not already logged in to Storefront Manager, log in with your usual OpenSRS credentials.
  2. Storefront shows which AI tool is asking for access and what it will be able to do. Check that Logged in as shows the account for the store you want to connect. If it doesn't, click Switch accounts and log in with the right one.
  3. Click Allow Access.

Storefront confirms that it's connected and sends you back to your AI tool. If you're not sent back automatically, use the return link on the page.

Back in Storefront Manager, the Storefront MCP page now shows Connected. You don't need to create or store an API key. The connection stays in place until you disconnect it.

Try it

Ask questions the way you'd ask a colleague who has your store open in front of them:

  • "How many active domains do I have, and how many expire this month?"
  • "Which customers created an account in the last two weeks?"
  • "Which TLDs sold best this year?"
  • "Show me the tax I collected each month this year."
  • "Show me any orders that failed this week and explain what happened with each one."

If an answer looks wrong, ask your AI tool to show which records it used, then compare them with Storefront Manager. Storefront Manager is always the authority on your store.

What your AI tool can see

Once connected, your AI tool can read the same store data you see in Storefront Manager:

DataIncludes
CustomersName, email, account status, the date the account was created, and the full customer record
DomainsDomain name, TLD, owning customer, expiry date, auto-renew status, domain status, the full domain record including nameservers, and your domain imports
OrdersOrder type (registration, transfer or renewal), status, domain, amount and date, plus each order's line items, payments, refunds and taxes
Products and subscriptionsYour recurring products and categories, and each subscription's customer, plan, status (active, past due or cancelled), next billing date, amount and currency
Store performanceYour dashboard summary (total orders, customers, domains and earnings) and an income statement for any date range
ReportsKPI, financial, tax and TLD reports, by day, month or year
PricingTLD pricing, add-on pricing including privacy protection, default markup, rounding rules, currencies and the full list of TLDs
Tax rulesYour tax rules and their tax IDs
Store settingsBranding, website content, default nameservers, DNS templates, custom code, and the name of your connected Stripe account
Email and notificationsYour email sending domains and their DNS authentication status, and your webhook and email notification settings
SearchSearch across customers, orders and domains at once, and your recent searches in Storefront Manager

Your AI tool can see which Stripe account is connected, but nothing held in Stripe itself, such as transactions or payouts. Payment, refund and subscription details come from Storefront's own records.

Get better answers about how Storefront works (optional)

Your AI tool can answer questions about your store data without any extra setup. To get better or more consistent answers about how Storefront features work, such as refunds or questions about the Storefront API, add Storefront's documentation to your AI tool as a knowledge source:

https://docs.storefront.opensrs.com/llms.txt

This index updates automatically whenever we update our documentation. If your AI tool doesn't accept a URL as a knowledge source, ask it to read the index when you have a how-to question.

Your data and your AI provider

When your AI tool looks up your store data, that data passes through your AI provider's systems so the AI can use it in its answer. This can include customer records and financial information, such as your earnings and reports. The AI provider's own terms and privacy policy apply to how it handles that data.

Storefront doesn't see your conversation with your AI tool; we only receive the data requests it makes.

Disconnect your AI tool

Disconnect when you stop using the AI tool, change AI providers, or want to cut off access immediately for any reason.

  1. Go to Settings → Developer Settings → Storefront MCP.
  2. Click Disconnect AI Tool.
  3. Confirm by clicking Disconnect AI Tool again.

Access ends straight away. Your AI tool can no longer read any of your store data, and Connection Status goes back to Not yet connected. Earlier conversations in your AI tool aren't affected, so anything the AI already showed you stays in those conversations.

Storefront may still be listed in your AI tool's settings. Remove it there too if you don't plan to reconnect. To reconnect later, start the connection again from your AI tool and approve it.

Troubleshooting

I added the URL to my AI tool, but Storefront still says Not yet connected.
The connection isn't finished until you click Allow Access on the Storefront approval page. Start the connection again from your AI tool's settings and complete the approval. If your browser blocks pop-ups, allow them for your AI tool, since that's how it opens the Storefront page.

The connection failed when I approved it.
Try connecting again from your AI tool. If it fails a second time, remove the Storefront server from your AI tool, add it again with a freshly copied URL from Settings → Developer Settings → Storefront MCP, and approve it. Contact support if it still fails.

My AI tool is showing data from the wrong store.
The connection was approved while you were logged in to a different Storefront Manager account. Disconnect it from the Storefront MCP page of the store it's connected to, then connect again, and use Switch accounts on the approval page to pick the right account.

My AI tool says it can't make a change I asked for.
Storefront MCP is read-only, so your AI tool can't make changes in your store. Make the change in Storefront Manager. Your AI tool can tell you where to find the setting.

My AI tool's answer doesn't match what I see in Storefront Manager.
Ask the AI tool to look up the data again, or to show you which records it used. AI tools sometimes answer from earlier in the conversation, or from general knowledge, instead of fetching fresh data. Starting a new conversation often helps.

Answers about how Storefront works are wrong or out of date.
Your AI tool is probably answering from general knowledge instead of our documentation. Add the llms.txt link above as a knowledge source, and ask the AI tool to link the page it used.

My AI tool says it has hit a rate limit.
Storefront limits how many data requests one store can make in a short period. Wait a few minutes and ask again. Questions that cover a narrower set of records, such as one month or one customer, use fewer requests.

I disconnected, but Storefront still appears in my AI tool.
Disconnecting in Storefront Manager ends the AI tool's access, but your AI tool doesn't remove the server from its own settings. Remove it in your AI tool.

Related articles


Did this page help you?