The Colossal MCP server gives AI coding assistants direct access to your store’s GraphQL API. Your assistant can query products, customers, orders, and analytics without leaving your editor.
MCP is a protocol that connects AI assistants to external data sources. The Colossal MCP server acts as a bridge between your AI tools and your store.
Prerequisites
- An AI assistant that supports MCP (Claude Code, Cursor, VS Code)
- Your Colossal API token from the admin dashboard
Installation
Claude Code
Cursor
VS Code
claude mcp add --transport http colossal https://mcp.colossal.sh --header "Authorization: Bearer YOUR_TOKEN"
Add to ~/.cursor/mcp.json:{
"mcpServers": {
"colossal": {
"url": "https://mcp.colossal.sh",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Add to VS Code settings:{
"mcp": {
"servers": {
"colossal": {
"type": "http",
"url": "https://mcp.colossal.sh",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
}
YOUR_TOKEN with your API token from the dashboard.
What you can do
Once connected, ask your AI assistant to work with your store data:
- Query products, customers, and orders
- Analyze sales and customer behavior
- Generate reports from commerce data
- Build apps using real store data
Available data
The MCP server provides read access to:
| Entity | Examples |
|---|
| Products | Name, pricing, variants, inventory, status |
| Customers | Contact info, order history |
| Orders | Line items, payment status, totals |
| Payments | Transaction history, payment methods |
| Projects | Organization structure, configuration |
Connection details
For other MCP-compatible clients:
| Setting | Value |
|---|
| Endpoint | https://mcp.colossal.sh |
| Protocol | HTTP |
| Auth header | Authorization: Bearer YOUR_TOKEN |
Troubleshooting
- Can’t connect — verify the endpoint URL and that your token is valid
- Field not found — use schema introspection to check available fields
- Rate limiting — wait between requests and retry
See the GraphQL API reference for the full schema. 