Key Concepts
Glossary of terms used throughout the ChatCast MCP documentation.
- Store Public ID
- Unique identifier for a store in the MCP endpoint URL. Assigned automatically when the store enables public MCP. Found in the brand console under Settings > AI Access.
- See also: Installation Guide
- Agent ID
- Identifier assigned when an agent calls register_agent. Used for attribution tracking in subsequent tool calls. Scoped to the store — the same agent must register separately with each store.
- See also: register_agent, Agent Commissions
- Discount Code
- Unique code per agent per campaign, following the pattern CC-{AGENT}-{RANDOM}. Automatically synced to Shopify. When a customer uses this code at checkout, the sale is attributed to the agent.
- See also: get_my_discount_code
- Commission Rate
- Percentage of the sale price paid to the referring agent. Set by the merchant. Default rate applies to all products. Campaign bonuses stack on top of the default rate. The rate is locked at the time of order placement.
- See also: get_commission_rates, Agent Commissions
- Campaign
- Time-limited promotion created by the merchant with an optional bonus commission rate and customer-facing discount. Campaigns have start and end dates. When active, the bonus rate stacks on top of the store's default commission rate.
- See also: get_active_campaigns
- Effective Rate
- The total commission rate for a sale: default_rate + campaign_bonus. Shown in the product _meta.commission.effective_rate field when an agent_id is provided in search or detail requests.
- See also: search_products
- Lock Period
- Time window after order placement during which commissions remain in "pending" status. Typically 14 days. Allows for returns and refunds before the commission is approved. After the lock period, commissions are auto-approved or manually approved by the merchant.
- See also: get_my_earnings
- MCP (Model Context Protocol)
- Open protocol for connecting AI agents to external tools and data sources. ChatCast implements the MCP server side, exposing store data as tools. AI agents connect as MCP clients using any compatible client library.
- See also: Quick Start
- Streamable HTTP
- The transport protocol used by the public MCP endpoint. Also referred to as HTTP+SSE (Server-Sent Events). Supports bidirectional communication over standard HTTP without WebSockets. Claude Desktop requires the mcp-remote bridge for this transport; Cursor and Claude Code support it natively.
- See also: Quick Start, Authentication
- Brand Console
- The merchant-facing dashboard at console.chatcast.io where store owners manage their ChatCast settings, commission rates, campaigns, and API keys. This is where merchants enable public MCP and find their Store Public ID.
- See also: Installation Guide