Skip to main content

AIQ MCP

AIQ MCP lets you connect Cursor, Claude, Copilot, and other assistants to your AIQ data.

What can AIQ MCP do?

AIQ MCP can read your account and create some new items. It cannot edit or delete anything, and it cannot send or turn a campaign on.

AIQ MCP is free to use. All MCP tools come at no cost.

What it can read

  • Account information:

    • Brand assets (logo, colors, and fonts)

    • Timezone

    • Store locations

    • Contacts, by name, email, phone, medical ID, or POS customer ID

  • Retail Analytics:

    • Run read-only analytics queries against business data

    • Answer questions about your own store data, such as top spenders, campaign results, messages sent, and discount redemptions

    • Find existing reports for a date range and audience (requires the retail analytics package)

    • Pull report details across summaries, charts, redemptions, points adjustments, Terpli questions and recommendations, Mobile app data, etc.

  • Marketing and Loyalty information:

    • Campaigns information, campaign performance for a date range. Open a campaign to read the subject, preheader, content blocks, text message, and status

    • Verified sender addresses

    • Audiences, discounts, signup forms, and surveys information

    • Automated flows statuses (draft, inactive, or active), shared flow template library

What it can create

  • Email campaigns (drafts only):

    • Subject, preheader, personalized copy, content blocks, buttons, links, theme colors, and image blocks

    • Saved as a draft

  • Text campaigns (drafts only):

    • A text message, or a linked landing page with content blocks, personalization, and discount links

    • Saved as a draft

  • Discounts (drafts only):

    • Dollar or percentage off, expiration, and a redemption limit

    • Each discount has to target at least one audience. You can also exclude audiences

  • Audiences:

    • Segments from traits such as lifetime spend, email opt-in, purchase history, and loyalty status

    • A new audience is active right away. It is not a draft

  • Automated flows (drafts only):

    • A flow with steps such as email, text, a wait, and a follow-up

    • Saved as a draft

  • Signup forms:

    • A loyalty signup form

    • It is live at a public join link as soon as it is created

  • Surveys:

    • A survey with questions

    • It is public right away unless you set a future start date

What it cannot do

  • Edit or delete any item, including one it just created. Changes are made in AIQ.

  • Send an email or text, or turn a campaign, discount, or flow on.

  • Upload or generate an image.

  • Start a new retail report. It can only open one that already exists.

  • Create a wallet pass, push, voice, or direct-mail campaign on its own. Those channels can appear as steps inside a flow.

Image uploads: The connector cannot upload a file into AIQ. Your assistant can only place an image that already has a link.

For an email or a text landing page, that link has to be one anyone can open in a browser. An image from your AIQ media library is the safest choice, because AIQ hosts it and it stays available. A link from another public site can also work. A file you drop into the chat is not a link, so AIQ cannot use it.

A picture attached directly to a text message is stricter. It has to be a file AIQ already hosts for your account, such as one in your media library. A link from another website will not save on that kind of message. Put the image on the landing page instead.

Example prompts

  • Account information:

    • What timezone is my account in?

    • What are our brand colors? What logo are we using?

    • List our store locations

  • Retail Analytics:

    • How did sales look over the last 90 days?

    • Pull the retail report for this quarter and summarize redemptions and points adjustments

    • What Terpli responses are people submitting, and what is being recommended?

    • How is our mobile app performing this month?

    • Compare our VIP audience with everyone for the last 30 days

  • Campaigns (read/create):

    • Which campaigns went out in the last 30 days?

    • Show the subject, preheader, and status for our last birthday campaign

    • What is the best performing campaign and what needs improvement?

    • Create a draft email for our weekend sale. Include a subject, a preheader, a short note about 20% off, and a button to the shop. Use our brand colors. Do not send it.

    • Create a draft birthday email with a personalized greeting and a shop button. Leave it as a draft.

    • Write a draft text for tomorrow's flash sale. Keep it short and include a link to the shop. Do not send it.

    • Create a draft text with a landing page for our new arrival. Put the product image on the landing page.

  • Discounts (read/create):

    • Which discounts are currently available?

    • Create a draft 20% off discount for our VIP audience. It should expire in 14 days, and each person can use it once.

    • Create a draft $10 off discount for people opted in to email. Exclude anyone who already used our welcome offer.

  • Audiences (read/create):

    • What audiences do we have?

    • Create an audience of customers who have spent more than $500 and are opted in to email.

    • Create an audience of loyalty members who have not purchased in the last 60 days.

  • Automated flows (read/create):

    • Which automated flows are active, and which are still in drafts?

    • Create a draft welcome flow: a text when someone signs up, a wait of 2 days, then an email with a first-visit offer. Do not turn it on.

    • Create a draft win-back flow for people who have not purchased in 45 days. Send one email, wait 3 days, then send a follow-up text.

  • Signup forms and surveys (read/create):

    • List our active signup forms and surveys

    • Create a loyalty signup form with our brand name, a short headline, and the standard name, phone, and email fields.

    • Create a signup form headline that says "Join our loyalty program" and a thank-you message after they submit.

    • Create a 3-question survey asking how their last visit went, what they bought, and if they would recommend us.

    • Create a survey that starts next Monday asking customers to rate their budtender.

  • Verified sender addresses (read):

    • Which email addresses are verified to send from?

Note: A signup form or survey prompt will publish the form or survey as soon as the assistant creates it.


How to connect AIQ MCP

  1. Go to Astro AI → MCP

  2. Click Create key, give it a name and optionally an expiration date

  3. Once the key is created, click Add to Agent in the table

  4. Select your desired agent in the popup modal

    1. Add to Cursor installs that key in your selected AI assistant tool

    2. Copy mcp.json is for an AI tool that accepts a remote URL config, such as Cursor

    3. Copy npx mcp.json is for an AI tool that starts a local process, such as Claude

    4. Add a Custom MCP. See details below


Connecting to Claude

In AIQ, go to Astro AI -> MCP.

  1. Click Create Key and give it any name you’d like.

  2. Under Account Keys, find the MCP URL and copy it.

  3. Open Claude Desktop and go to Customize > Connectors.

  4. Use the dropdown to select Add Custom Connector -> Web.

  5. Paste the MCP URL you copied and name the connector (for example, “AIQ MCP”).

  6. Fill in these steps

    1. Authentication - Sign in now

    2. OAuth client - Use Claude’s published identity

    3. Add

  7. A tab in your browser should open with the label ‘Claude wants to connect’

    1. Follow the prompts to connect and log-in

  8. Connect -> the tab should return to Claude and the connector should show as connected.

Disconnecting from Claude

Disconnecting stops the assistant from using AIQ. Items it already created stay in AIQ.

  1. Open Customize, then Connectors. On some accounts this is Settings, then Connectors.

  2. Find the AIQ connector.

  3. Choose Disconnect to sign out of this account, or Remove to delete the connector.

  4. To use a different AIQ account, disconnect first, then connect again and approve that account.


Connecting to ChatGPT

In AIQ, go to Astro AI -> MCP.

  1. Click Create Key and give it any name you’d like. Or use an existing key already created.

  2. Under Account Keys, find the MCP URL and copy it.

  3. Open ChatGPT: Sign in at chatgpt.com using a desktop browser.

  4. Open Plugins: Navigate to the Plugins page and select Add or +.

  5. Add your MCP server: Select Add custom MCP server.

  6. Enter connection details: Provide the server name, endpoint URL, select OAuth

  7. A tab in your browser should open with the label ‘Chat GPT wants to connect’

    1. Follow the prompts to connect and log-in

  8. Review and connect: Verify the server information and approve the connection.

  9. Test the connection: Open a new chat, select the connected app, and run a read-only test to confirm the server is working.

Note: Custom MCP availability depends on your ChatGPT plan and workspace permissions. If the option isn't available, check OpenAI's official setup guide.

Disconnecting from ChatGPT

Disconnecting stops the assistant from using AIQ. Items it already created stay in AIQ.

  1. Open Settings, then Apps. On some accounts this is Settings, then Plugins.

  2. Open the AIQ app.

  3. Open the more options menu (•••) and choose Disconnect.

  4. To use a different AIQ account, disconnect first, then connect again and approve that account.


Revoking a key in AIQ

Revoking only turns off a key. It does not disconnect a Claude or ChatGPT sign-in. Those are removed in Claude or ChatGPT.

  1. Open Astro AI, then MCP. The page title is AIQ MCP.

  2. Find the key in the list.

  3. Click Revoke.

  4. Confirm Revoke. That key stops working immediately.

Note: An account owner can revoke a key for any login on the account. Anyone else can revoke only their own keys. The MCP menu is shown to account owners.


One connection, one account

Each connection is tied to the account you choose when you approve it. Everything your assistant reads or creates stays on that account.

If your login has more than one account

  1. Start the connection and approve the account you want.

  2. Use that connection for that account only.

  3. To work in another account, connect again and choose that account.

  4. On Claude, disconnect the current connection first, then connect the other account.


Need Help?

If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.

To learn how AIQ collects, uses, and protects your data, see our Privacy Policy.

Did this answer your question?