Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.colossal.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
What is the Colossal MCP?

The Colossal Model Context Protocol (MCP) server provides direct access to your store’s GraphQL API from AI coding assistants like Claude, Cursor, and VS Code. This enables your AI assistant to query products, customers, orders, and manage your entire commerce platform programmatically.
MCP is a protocol that allows AI assistants to securely connect to external data sources and APIs. Our MCP server acts as a bridge between your AI tools and your Colossal store.

​
What you can do

With the Colossal MCP connected, your AI assistant can:
  • Query products, customers, orders, and inventory directly from your store
  • Analyze sales performance and customer behavior
  • Generate reports and insights from your commerce data
  • Build custom tools and integrations with real store data

​
Prerequisites

Before installing the Colossal MCP, ensure you have:
  • An AI coding assistant that supports MCP (Claude Code, Cursor, VS Code with MCP extension)
  • Your Colossal API token for authentication
  • Basic familiarity with GraphQL queries

​
Getting Your API Token

Before installing the MCP, you’ll need your Colossal API token for authentication:
  1. Log in to your Colossal dashboard
  2. Go to Admin → MCP
  3. Copy your API Token or use the pre-configured MCP setup for your client

​
Installation

​
Claude Code

Install the Colossal MCP server using Claude Code’s built-in MCP manager: 
claude mcp add --transport http colossal https://mcp.colossal.sh --header "Authorization: Bearer YOUR_TOKEN"
Replace YOUR_TOKEN with your API token from the admin dashboard, or copy the pre-configured command directly from the API Keys page.

​
Cursor

Add the following configuration to your ~/.cursor/mcp.json file: 
{
  "mcpServers": {
    "colossal": {
      "url": "https://mcp.colossal.sh",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
Replace YOUR_TOKEN with your actual API token, or copy the pre-configured JSON directly from the MCP page.

​
VS Code

Configure the MCP server in your VS Code settings: 
{
  "mcp": {
    "servers": {
      "colossal": {
        "type": "http", 
        "url": "https://mcp.colossal.sh",
        "headers": {
          "Authorization": "Bearer YOUR_TOKEN"
        }
      }
    }
  }
}
Replace YOUR_TOKEN with your actual API token from the admin dashboard.

​
Other MCP Clients

For other MCP-compatible clients, use these connection details:
  • Endpoint: https://mcp.colossal.sh
  • Protocol: HTTP
  • Authentication: Bearer token with your User ID
  • Header: Authorization: Bearer YOUR_TOKEN

​
Basic Usage

Once connected, you can ask your AI assistant to interact with your store data:

​
Query Products

Show me all my published products with their prices
Your assistant will execute a GraphQL query like: 
query GetProducts {
  products {
    uid
    name
    description
    price
    displayPrice
    status
  }
}

​
Analyze Orders

What's my total revenue from paid orders this month?

​
Customer Insights

List customers who have made more than 3 purchases

​
Available Data

The MCP server provides access to your complete store schema including:
  • Products - Name, description, pricing, features, status
  • Customers - Contact information, order history, entitlements
  • Orders - Order details, line items, payment status, totals
  • Payments - Transaction history, payment methods, amounts
  • Projects - Organization structure and pages

​
Troubleshooting

​
Connection Issues

If you can’t connect to the MCP server:
  1. Verify the endpoint URL: https://mcp.colossal.sh
  2. Check your internet connection
  3. Ensure your MCP client supports HTTP transport
  4. Restart your AI assistant and try again

​
Query Errors

Common issues when querying data:
  • Field not found - Use schema introspection to verify available fields
  • Missing variables - Ensure all required query variables are provided
  • Rate limiting - Wait a moment between requests and retry

​
Getting Help

If you need assistance:
Ready to enhance your AI coding workflow? Install the Colossal MCP and start building smarter commerce solutions today.