Model Context Protocol (MCP)

Set up the Colossal MCP server to give AI coding assistants direct access to your store’s products, customers, orders, and analytics via GraphQL.

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

claude mcp add --transport http colossal https://mcp.colossal.sh --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "colossal": {
      "url": "https://mcp.colossal.sh",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

VS Code

Add to VS Code settings:

{
  "mcp": {
    "servers": {
      "colossal": {
        "type": "http",
        "url": "https://mcp.colossal.sh",
        "headers": {
          "Authorization": "Bearer YOUR_TOKEN"
        }
      }
    }
  }
}

Replace 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.