Skip to main content

AIQ MCP

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

Included in our 09/29/2026 release

What can AIQ MCP do?

AIQ MCP has read-only capabilities, meaning once it's connected to your account it can pull information and reports across your account information, retail analytics, marketing, and loyalty information. Some examples below:

  • Account information:

    • Brand assets (logo and colors)

    • Timezone

    • Store locations

  • Retail Analytics:

    • Run read-only analytics queries against business data

    • Find existing reports for a date range and audience

    • 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

    • Verified sender addresses

    • Audiences, discounts, signup forms, and surveys information

    • Automated flows statuses, shared flow template library

Note: At this time, you cannot create or edit campaigns, audiences, discounts, flows, signup forms, or surveys.

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

  • Marketing and Loyalty information:

    • Which campaigns went out in the last 30 days?

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

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

    • What audiences do we have?

    • Which discounts are currently available?

    • Which email addresses are verified to send from?

    • List our active signup forms and surveys

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


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 Claude or 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



Most AIQ MCP tools come at no cost. The one exception is run-analytics, which uses AI to build the queries behind custom analytics questions. That tool has a usage charge.

Finding and opening your existing reports is always free, using find-retail-report and get-retail-report-data. These work with AIQ's standard retail analytics reports, such as Retail Analytics.

Did this answer your question?