Enables access to Shopify store data, allowing for the retrieval and searching of products, orders, and customer profiles either directly or proxied through AIVA.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AIVA MCP ServerShow me customers at high risk of churning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AIVA MCP Server
Model Context Protocol server for AIVA - Connect your AI coding tools to AIVA's customer intelligence and Shopify data.
What is this?
AIVA MCP is a Model Context Protocol server that gives AI coding assistants (Claude, Cursor, Windsurf, etc.) direct access to:
Customer Intelligence - RFM segments, health scores, churn predictions
Subscription Data - Active subscriptions, delivery schedules, lifecycle events
Affiliate Tracking - Referral codes, commissions, leaderboards
Shopify Store Data - Products, orders, customers (proxied through AIVA)
Quick Start
Installation
Configuration
Add to your MCP configuration file:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
Cursor (.cursor/mcp.json in your project):
VS Code with Continue (.continue/config.json):
Getting Your API Key
Log in to your AIVA Merchant Dashboard
Go to Settings > API Keys
Create a new API key with the scopes you need
Copy the key and add it to your MCP configuration
Available Tools
Once connected, your AI assistant can use these tools:
Customer Intelligence
Tool | Description |
| Get customer profile by ID or email |
| Search customers with filters |
| Get RFM segment breakdown |
| Get customers at risk of churning |
Subscriptions
Tool | Description |
| Get subscription details |
| List subscriptions with filters |
| Get upcoming deliveries |
| Pause, resume, skip, swap products |
Affiliates
Tool | Description |
| Get affiliate details |
| List affiliates with stats |
| Get referral history |
Shopify (Proxied)
Tool | Description |
| Search/list products |
| Get product by ID |
| List orders |
| Get Shopify customer |
Environment Variables
Variable | Required | Description |
| Yes | Your AIVA API key |
| No | Custom API URL (default: https://api.aiva.io) |
| No | Direct Shopify access (bypasses proxy) |
| No | Your Shopify store domain |
Example Usage
Once configured, ask your AI assistant things like:
Development
Running Locally
Testing
Building
Troubleshooting
"AIVA_API_KEY not configured"
Make sure your API key is set in the env section of your MCP configuration.
"Connection refused"
Check that:
Your API key is valid
You have network access to the AIVA API
The MCP server started correctly
Debug Mode
Set DEBUG=aiva:* environment variable for verbose logging:
Related Packages
@getaiva/create-app- CLI to scaffold AIVA-powered appscustomer-portal-starter- Customer portal starter kit
License
MIT - see LICENSE for details.