Connect your AI to Swirvle
With this connection, you can ask ChatGPT or Claude about your business on Swirvle: sales, products, customers, promotions, and cash register closures. It answers with your real numbers.
AI can also suggest promotions or price changes to you. It never does them on its own: it gives you a link, you review it in Swirvle, and you approve or reject it.
Before you begin
You need an administrator account for your business in Swirvle.
Your Swirvle subscription must be active.
You need a ChatGPT or Claude account. It works with the free ChatGPT account.
Do it from a computer, in the browser. Afterwards, it also works in the mobile app.
1. Copy your connection address
In Swirvle, go to AI Connections (in the side menu; in Loyalty it is under My Account) and copy the connection address. It is the same for all businesses:
https://mcp.swirvle.com/mcp
2a. If you use ChatGPT
In ChatGPT, go to Plugins (in the side menu, or at chatgpt.com/plugins), click Add, and choose Add custom MCP server.
Name it Swirvle, paste the connection address into Server URL, and leave OAuth as the authentication method. Check I understand and want to continue and click Create as plugin.
Click Continue to Swirvle. A Swirvle page will open with your business name: click Connect. If prompted to sign in, use your administrator account.
If ChatGPT is requesting access to your account appears, click Allow access. You will return to ChatGPT with Swirvle under Installed.
In a new chat, type @Swirvle and ask: “What is my business profile?”.
The first time you ask for a promotion, ChatGPT will ask if it can use Swirvle: click Allow once. This only creates the proposal; you approve it later in Swirvle.
2b. If you use Claude
In Claude, go to Settings → Connectors, click Add, and select Add custom connector.
Name it Swirvle, paste the connection address, and click Continue. Do not add headers.
Click Connect. A Swirvle page will open with your business name: click Connect again. If prompted to sign in, use your administrator account.
If Claude is requesting access to your account appears, click Allow access.
In a new chat, enable the Swirvle connector and ask: “What is my business profile?”.
What to ask them
Write to it like you would write to your accountant or your manager. Always state the time period (“yesterday,” “last week,” “October”). The AI only sees what your business has in Swirvle: if you don't use the point of sale, it won't answer about sales or inventory.
If you use Swirvle Loyalty
“How did I do last week compared to the previous one?”
“How many visits and new customers did I have in October at each branch?”
“How many customers haven't visited in the last 3 months?”
“Who are my top 10 customers by spend this month?”
“What promotions do I have active and how have they performed?”
“Look up [customer name] and tell me how many points they have and when they last visited.”
To take action: “Create a 20% promotion for customers who haven't visited in 3 months, valid this weekend.”
If you also use Swirvle Point of Sale (POS)
“How much did I sell last week at each branch? Which one sold the most?”
“What were my top 10 best-selling products in October?”
“Which products am I running low on and how much should I restock?”
“Did this week’s cash register reconciliations balance? Were there any shortages?”
When you ask it to take action, the AI puts together the proposal and gives you a link. Open it, review what is going to happen, and approve it if you agree. The link expires in 24 hours.
Good to know
Nothing reaches your customers without your approval. Coupons, campaigns, double points, published rewards, and price changes remain "pending approval" in Swirvle, under AI Approvals.
There are two things the AI does directly: create a hidden reward, which no customer sees until you publish it, and, if you use the point of sale, create an internal discount code (up to 50%, with a maximum expiration date of 90 days).
It does not: invoice, cancel sales, adjust inventory, or delete anything.
There is a limit of 300 queries per day per business. It resets at midnight, Mexico time.
If the AI gives you a figure that doesn't match Swirvle, compare it on the Swirvle screen and let us know.
To disconnect: in Swirvle, go to AI Connections → Disconnect. It disconnects immediately.
What data the AI sees and what is stored: AI privacy policy and connection terms.
If something goes wrong
"For now, only a business admin can connect an AI assistant."
Sign in with the owner or an administrator account.
“Your business subscription is not active.”
Reactivate your subscription on Swirvle and reconnect.
“Your plan does not include connecting to AI assistants.”
Write to us to review your plan.
"The connection request timed out."
Go back to ChatGPT or Claude and click Connect again.
“Your email is already linked to another account.”
Write to us at support.
The AI says you've reached the query limit
Wait until tomorrow; it resets at midnight.
Support
Questions or something isn't working? Email us at hugo@swirvle.com. You can also report any security issues there.

