Skip to content

AI Assistants

Connect Claude, ChatGPT, Grok or Muse to your store to look up products, orders, customers and sales, and make the changes you allow

Updated View as Markdown

AI Assistants

Connect Claude, ChatGPT, Grok or Muse to your store and ask about your business in plain English: “which handguns are low on stock?”, “where is order 4021?”, “how did sales this month compare to last month?”. If you allow it, the assistant can also make changes for you: import products from your distributors at your markup, update prices and markups, adjust stock, rewrite product descriptions, specs and SEO, organize your collections, create discount codes, pause or cancel Reload subscriptions, and rework your storefront’s theme and pages.

The assistant signs in with your FirearmCart account, so there’s no API key to copy. You choose what it may do, and you can change that or disconnect it at any time.

The same assistant is also built into your dashboard, with nothing to connect: see AI Assistant.


Requirements

Requirement Details
Role Store owner or administrator. Members can’t connect assistants.
Plan API access: included with the Pro plan, or with the AI & API Access addon on any plan
Assistant One that supports custom MCP connectors: Claude, ChatGPT, Grok, Grok Bot, Muse or Claude Code

Connecting an Assistant

Every assistant uses the same connector address:

https://api.firearmcart.com/mcp

Step 1: Add the Connector

Assistant Where to add it
Claude (claude.ai and desktop) Customize → Connectors → Add → Add custom connector, then follow the Claude steps below
ChatGPT (chatgpt.com) Plugins → + → Add custom MCP server, then follow the ChatGPT steps below
Grok (grok.com) Connectors → New Connector → Custom, then paste the address
Grok Bot Ask it to “add a custom MCP server named FirearmCart at https://api.firearmcart.com/mcp”, then use the connect card it shows
Muse (Meta: web, iOS and Android) In a chat, ask it to “create a custom connector named FirearmCart for the remote MCP server at https://api.firearmcart.com/mcp, using Streamable HTTP with OAuth sign-in”, then use the connect card it shows
Claude Code Run claude mcp add --transport http firearmcart https://api.firearmcart.com/mcp, then /mcp to sign in

On Grok Business and Enterprise, a workspace admin adds the connector first.

In Claude, on claude.ai or in the desktop app:

  1. Open Customize → Connectors, click Add and choose Add custom connector.
  2. Name it FirearmCart, enter the address as the server URL and click Continue.
  3. Keep Sign in now under Authentication, and choose Register automatically under OAuth client. Claude usually picks both for you and marks them Detected.
  4. Click Add, then Connect to open the FirearmCart sign-in page (Step 2).

On Claude Team and Enterprise, an Owner adds the connector under Organization settings → Connectors (Add → Custom, then Web if asked) with the same settings. Each person then finds it under Customize → Connectors, marked Custom, and clicks Connect. Once connected, it also works in the Claude mobile apps.

In ChatGPT, add it on the web:

  1. Open Plugins, click the + button and choose Add custom MCP server.
  2. Name it FirearmCart, and under Connection enter the address as the Server URL.
  3. Under Authentication, choose OAuth.
  4. Select I understand and want to continue, then click Create as a plugin.
  5. Open FirearmCart on the Personal tab of Plugins and click + to install it.

Once you’ve signed in (Step 2), type @ in a chat and choose FirearmCart to use it. On personal ChatGPT plans such as Pro, FirearmCart can only look things up. To let it make changes, you need a ChatGPT Business, Enterprise or Edu plan, where an admin may need to allow you to add custom MCP servers.

Step 2: Sign In and Choose What It May Do

The assistant opens a FirearmCart page titled “Connect the app to your store”. Sign in if you’re asked to, then:

  1. Check that Return address shows the assistant you just started from, such as claude.ai, chatgpt.com or grok.com. Muse shows an agent.meta.ai or muse.ai address. Known assistants show a Verified domain badge. If you didn’t just start connecting an app, click Cancel.
  2. Choose the store. Stores you can’t connect are greyed out, with the reason next to them.
  3. Review View access. It’s always included: the assistant can look up everything listed there, but not change it.
  4. Under Optional actions, tick only the changes you want it to make. Nothing is ticked to start with, unless you’re reconnecting an app: then the actions it already had are ticked.
  5. Click Connect. You’re sent back to the assistant, which is now connected.

Each connection covers one store. Reconnecting an app replaces its connection to the store you choose, so it isn’t listed twice.


What It Can See and Change

View access is always included:

Permission Lets the assistant
Products, prices & stock Find products by name, SKU, barcode, manufacturer or brand, by who supplies them (your own stock or a distributor), or the ones missing a shipping weight or tax code, with variants, cost, MAP, where the stock comes from, shipping weight, tax code, and each product’s description, specs and SEO fields, plus your collections, the catalogs of the distributors you’ve switched on (with your cost, MAP and stock for each item) and, with Avalara or TaxJar on, the plugin’s tax codes
Orders, fulfillment & tracking Look up orders by number, customer, status or date, with items, who ships each line, FFL dealer, tracking and the order note, and list the orders that need you
Customer information Find customers by name, email or phone, with their orders and total spent
Sales & traffic reports Orders, revenue, average order value and top products for a period, and visits, conversion rate, traffic sources and landing pages, compared with the period before
Discount codes List discount codes with their usage and dates
Subscriptions List Reload subscriptions, for stores using Reload
FFL dealer directory Find FFL dealers by name, license number or ZIP code
Store settings, shipping & taxes Read your store details, branding, payment gateways (never their keys), domains, shipping zones, tax zones, the plugins in the marketplace and which are on, and what’s left before launch
Storefront themes & content Browse your themes and their files, pages, blogs, policies, menus and media, and take screenshots of a theme

Every connection can also search these help docs, so you can ask how something in FirearmCart works, like “how do I require an FFL for ammunition in some states?”. The assistant answers from the docs and links the page.

Optional actions are off until you tick them:

Permission Lets the assistant
Edit products & collections Add products, import them from your distributors at the markup you choose (as drafts unless you ask for them to go live), change a product’s or variant’s price or compare-at price, set the markup on many products at once, publish or unpublish a product, rewrite its description, specifications and SEO title and description (distributor products included), set shipping weights and, with Avalara or TaxJar on, tax codes, add collections and move products between them, change product images and collection covers, and add images to your media library
Update stock levels Set or adjust the stock your store holds itself
Fulfill and update orders Add tracking for a parcel you shipped, send an order’s waiting lines to your distributors or ShipStation (after you approve the plan), change who ships a line, add to order notes and change the receiving FFL
Create and update discount codes Create codes, turn them on or off, and change their dates, usage limit or minimum purchase
Pause, resume, skip or cancel subscriptions Manage one Reload subscription at a time
Edit store settings, shipping & taxes Change your store details, social links, logo, favicon and checkout logo, and whether your FFL shows at checkout; set your store FFL from a copy of your license; connect a custom domain; add and change shipping zones and rates, and tax zones
Edit and publish storefront content Edit a copy of your theme and publish it, create or update pages, blog articles, policies and collection filters, build, change or delete navigation menus or generate one from your catalog, and add images to your media library

No permission lets an assistant charge cards, issue refunds or move money, cancel orders or change their items and prices, edit customer details, or delete products.

Themes: with Edit and publish storefront content ticked you can ask for storefront work too, such as “make the homepage hero match this mockup”. The assistant edits a copy of your live theme, shows you screenshots, and publishes only when you say so. Every save is versioned, so a change can be undone.

Images: with either edit permission ticked, an assistant can add an image to your media library (Content > Files). It can use a web address you give it, a file you attach in ChatGPT, or, for assistants that can run commands such as Claude Code and Grok Bot, a file on their own machine. In other apps, upload the image on the Files page and tell the assistant; it finds it there. It can then add the image to a product (as the main image or for a variant, with alt text), use it as a collection’s cover, or set it as a blog article’s featured image. Only give it images you own or may use.

Products and collections: with Edit products & collections ticked you can ask for things like “add the Federal 9mm 115gr FMJ 50-round box at $18.99 with 40 in stock”, “write SEO titles for my 9mm handguns”, “add the barrel length and finish to product 1042” or “put the products in no collection into the right ones”. A new product is saved as a draft unless you ask for it to go live, and the assistant tells you whether it needs an FFL and how it ships, which come from its product type. The assistant shows you the new text before saving it and is told never to guess a spec. Specs use the same names as the product page, so they keep feeding marketplace feeds such as AmmoSeek and Google Shopping and your collection filters. Distributor syncs only update stock, cost and pricing, so your descriptions, specs and SEO stay as you set them.

Orders: with Fulfill and update orders ticked you can ask “which orders need me?”, “I shipped order 1042 with UPS 1Z999AA10123456784” or “send order 1042 to RSR”. Before an order goes to a distributor, the assistant shows you what goes to whom and what it costs, and sends only that once you say yes. Order changes follow the same rules as the order page: who ships a line can change only until it’s sent, and the receiving FFL only until a firearm has gone out.


How Changes Stay Safe

  • You confirm first. The assistant reads the record, tells you the change it plans (for example “Glock 19 price: $549.99 → $529.99”) and waits for your yes. Most apps also ask you to approve each change.
  • One record at a time. Each change touches a single product, variant, discount code or subscription. The exceptions are a tax code, a markup and an import from a distributor, which can cover many products at once: the assistant previews the change, tells you how many products it covers, and saves it only for that same set.
  • Imports follow your distributor’s page. An import takes items only from your own catalog with that distributor, waits for its first catalog sync, and stays within your plan’s product limit. New products are priced at your cost plus your markup, never under MAP, and arrive as drafts unless you ask for them to go live. A product you deleted comes back as it was, and an item with the same UPC as one of your products joins that product as another supplier; the assistant tells you about both first.
  • Nothing is overwritten by mistake. If the record changed after the assistant read it, for example because a distributor sync updated the price, nothing is saved and the assistant has to read it again.
  • Price guardrails. Prices below MAP are refused. A price below cost, or more than double or under half the current price, is only saved after you confirm that exact number.
  • Only your own stock. Distributor stock, and stock synced from Lightspeed, FastBound or Orchid eBound, updates from its source, so an assistant can’t change it. An assistant sets a product’s name, type, cost and SKU only when it adds the product; after that they’re changed on the product page.
  • Shipping weights you give it. An assistant sets a weight only when you gave or confirmed it, never a guess. That includes products from a distributor: their weight is copied from the distributor once, when you import them, and syncs never change it, so a corrected weight stays.
  • Tax codes from your tax plugin’s list. An assistant sets only codes Avalara or TaxJar lists, never a guess, and you choose which. New orders are taxed under the new code; orders already placed keep the code they were taxed under.
  • Collections keep their addresses. Collections come from FirearmCart’s list of collection types, one per type, and a product sits in one at a time. Changing a collection’s type changes its web address, so the assistant needs your OK first. Collections are only deleted on the Collections page.
  • Compliance specs stay put. A magazine capacity or action type spec decides which states a product can ship to and when it needs an FFL. An assistant can add one a product is missing, but one it already has can only be changed on the product page.
  • Clean descriptions. Descriptions keep the formatting the product page editor offers. Scripts, embedded frames and images are removed.
  • Orders go to distributors only as you approved them. Before sending an order to a distributor, the assistant shows you the plan: what goes to whom, where it ships and what it costs. It sends exactly that plan, and only once. Test orders, local pickups and unpaid or refunded orders are never sent, and an order that already shipped gets tracking instead.
  • Limits. Your AI apps can make up to 240 requests a minute for each store, and there’s no cap on changes: your app runs on your own AI account.
  • Everything is recorded. Every change an assistant tries, whether it was saved or refused, is recorded with the app and the person who connected it.

Price, status, stock and content changes reach your storefront within a minute.


Making Bulk Edits

A connected app is the best way to change many products, such as setting shipping weights on hundreds of products or writing SEO titles for a whole collection. There’s no cap on its changes, it runs on your own AI account, and one chat can work through a long list. The AI assistant in your dashboard suits smaller jobs: it makes up to 300 changes a day for each store, and you approve them in batches of up to 25.

  1. Connect the app with Edit products & collections ticked (see Connecting an Assistant).
  2. Ask for one job at a time and say which products it covers, for example “set the shipping weight on every product missing one, using this list” or “write SEO titles for the products in my Handguns collection”.
  3. Give it what it can’t look up. It sets only the weights you give or confirm, and it never invents a spec.
  4. Check its first few changes, then let it carry on. Most apps ask before each change, and many let you allow a tool for the rest of the chat, so a long list keeps moving.
  5. Spot-check a few products in the dashboard when it’s done.

An import from a distributor or a new markup covers up to 500 products in one change, so it doesn’t need a long list: ask, for example, “import every in-stock Hornady item from Lipsey’s at a 25% markup” or “set my RSR handguns to a 15% markup”.

To publish, unpublish, reprice, delete or move many products into a collection, the Products list’s bulk actions are quicker: see Changing Many Products at Once.


Managing Connected Apps

Open the profile menu (your avatar, top right) and choose API Tokens. The Connected apps section lists every app connected to the current store, who connected it, whether it has View access only or View & change, and when it was last used.

From the actions menu next to an app:

  • Edit access - Choose which changes it may make. View access always stays on. A change you turn off stops on the app’s next request. One you turn on shows up once the app reloads its tools, which most apps do when you start a new chat. If it still doesn’t show up, reconnect the app: that replaces the connection and keeps the actions you ticked. Only the person who connected an app can allow it more actions; anyone else who manages your apps can take actions away.
  • Disconnect - Cut it off straight away. To use it again, connect it from the app.

Everyone on your team gets an alert in the dashboard and by email when an app is connected. This alert can’t be turned off, so a connection nobody expected gets noticed.

An app is also disconnected when the person who connected it is changed to Member or removed from the store. While the store’s plan doesn’t include API access, or its subscription has expired, connected apps stop working until that’s fixed.


Troubleshooting

A Store Is Greyed Out on the Sign-In Page

The reason is shown next to the store:

Reason What to do
Only the store owner or an admin can connect apps. Ask the owner to make you an administrator, or to connect the app themselves
API access isn’t included in this store’s plan. Upgrade to Pro, or add the AI & API Access addon
This store’s subscription has expired. Renew under Billing

The Sign-In Page Says It Has Expired

This page has expired means the FirearmCart page you clicked can’t be used anymore. Each sign-in page works once, and it stops working when a newer one opens, for example if you started connecting again in another tab. Close the extra tabs, go back to the assistant and start the connection again.

The Assistant Says It Isn’t Authorized

The app was disconnected, the person who connected it is no longer an administrator, or it hasn’t been used for 30 days. Connect it again from the app.

The Assistant Says It Made Too Many Requests

Your AI apps can make up to 240 requests a minute for each store, all apps together. Wait a minute and try again.

ChatGPT Reads but Won’t Change Anything

On personal ChatGPT plans such as Pro, FirearmCart can only look things up. Making changes needs a ChatGPT Business, Enterprise or Edu plan, with the change permissions ticked when you connected.

An App I Don’t Recognize Was Connected

Disconnect it under API Tokens → Connected apps, then check who connected it and review your team’s roles under Users.


Using an API Token Instead

Developer tools that send a fixed key instead of signing in, such as Claude Code, Cursor or the Grok CLI, can use a store API token. See Using an API token.


Navigation

Type to search…

↑↓ navigate↵ selectEsc close