Suita

Core Concepts

MCP Server

How Suita's Model Context Protocol server lets AI agents call real tools against your live catalog.

The Model Context Protocol (MCP) is an open standard for letting AI agents call tools — structured, named functions with typed inputs and outputs — against a live system, instead of scraping and guessing from HTML.

Every Suita-connected store exposes a real, spec-compliant MCP server at https://your-store.com/mcp, speaking JSON-RPC 2.0 over HTTP exactly as the protocol defines it. Any MCP-aware client — Claude's custom connectors, or any other MCP client — can connect to it directly.

Tools exposed

  • get_products — list and filter published products by category, price, or attribute
  • get_product — full product detail: price, stock, dimensions, material, brand, images
  • search_products — keyword search across the full catalog
  • get_inventory — real-time stock levels per SKU
  • get_coupons — active discount codes and eligibility rules
  • get_shipping_rates — shipping cost and delivery estimate for a product, quantity, and destination
  • create_checkout — prepares a real order and returns a checkout link (opt-in, see AI Checkout)

Connecting Claude to your store

  1. In Claude, add a custom connector and set its URL to https://your-store.com/mcp.
  2. Claude calls initialize and tools/list automatically to discover what your store supports.
  3. Ask Claude something like "search this store for a walnut dining table and check if it's in stock" — it will call search_products and get_inventory directly against your live data.
Example call
POST https://your-store.com/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": { "query": "walnut dining table" }
  }
}

Next: AEO optimization