Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.toebox.ai/docs/llms.txt

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

The Model Context Protocol (MCP) is an open standard that lets AI models interact with external tools and data sources. ToeBox uses MCP to connect your agents to Shopify and other services.

​
What is MCP?

MCP provides a standardized way for AI agents to:
  • Discover tools — Agents learn what tools are available and what they do
  • Call tools — Agents can invoke tools with structured parameters
  • Receive results — Tool outputs are returned in a format the agent understands
This means your ToeBox agents can search products, create checkouts, query databases, and more — all through a unified protocol.

​
Transport: Streamable HTTP

ToeBox uses Streamable HTTP as the MCP transport protocol. This is simpler than WebSocket or SSE-based transports:
  • No persistent connections to manage
  • Works through standard HTTP proxies and firewalls
  • Each tool call is a single HTTP request/response
You do not need to configure transport settings. ToeBox handles the connection setup automatically.

​
Connecting Shopify MCP servers

ToeBox comes with pre-configured connections to Shopify’s official MCP servers:
What it does: Product search and discovery across your Shopify store.Endpoint: https://discover.shopifyapps.com/global/mcpAvailable tools:
  • search_products — Search by keyword, filter by price, availability
  • get_product_details — Retrieve full product information
  • browse_collections — List and browse product collections
This is automatically enabled for agent types that need product data (Product Recommendation, Customer Support, Marketing, Sales Assistant, etc.).

​
Testing MCP connections

You can test MCP connections from the agent configuration page:
  1. Open your agent’s settings
  2. Navigate to the MCP Tools section
  3. Each connected server shows a status indicator (connected/disconnected)
  4. Use the Test button to verify the connection is working
If a connection test fails, check that your Shopify store is active and that the required API scopes are granted. ToeBox needs product and checkout scopes to function.

​
Exposing your agents via MCP

ToeBox also provides an MCP endpoint that lets external tools connect to your agents. This means you can use your ToeBox agents from:
  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code
  • Any MCP-compatible client
Find your MCP endpoint URL in Settings > MCP Endpoint. The connection URL format is: 
https://app.toebox.ai/mcp?api_key=tb_xxxxx

​
Claude Desktop / Claude Code configuration

Add this to your MCP configuration file: 
{
  "mcpServers": {
    "toebox": {
      "url": "https://app.toebox.ai/mcp?api_key=tb_your-api-key"
    }
  }
}
The MCP endpoint uses Streamable HTTP transport. No WebSocket or SSE setup is needed — just paste the URL into any MCP client.