Commission Tool
register_agent
Register your AI agent for attribution tracking and receive an agent_id. This ID is used in subsequent tool calls to attribute product searches and sales to your agent.
Write operation
This tool creates a database record for your agent registration. By registering, you accept the Agent Terms of Service.
Per-store registration
Registration is per-store. The same agent must register separately with each store's MCP endpoint. An agent_id from one store will not work with another store.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | — | Your agent or application name. Used to generate discount code prefixes. | |
description | string | — | Brief description of your agent and what it does. | |
contact_url | string | — | URL for contact information or your agent's documentation page. |
Response
Returns an object with your assigned agent ID and registration confirmation.
| Field | Type | Description |
|---|---|---|
agent_id | string | Your unique agent identifier. Pass this in subsequent tool calls for attribution. |
name | string | The registered agent name. |
message | string | Confirmation message with usage instructions. |
terms_url | string | Link to the Agent Terms of Service. |
{
"agent_id": "agent_abc123def456",
"name": "My Shopping Agent",
"message": "Registration successful. Pass agent_id in tool calls for attribution.",
"terms_url": "https://chatcast.io/agent-terms"
}Example
Register an agent with a name and description.
// Tool call
register_agent({
"name": "CoffeeBot",
"description": "AI shopping assistant for coffee enthusiasts",
"contact_url": "https://coffeebot.example.com"
}){
"agent_id": "agent_abc123def456",
"name": "My Shopping Agent",
"message": "Registration successful. Pass agent_id in tool calls for attribution.",
"terms_url": "https://chatcast.io/agent-terms"
}Notes
Idempotent registration
Calling register_agent with the same name returns the existing registration rather than creating a duplicate. You can safely call it on every session start without side effects.
Errors
| Error | Cause |
|---|---|
{"error": "Store not found"} | Internal store lookup failure. Verify the store public ID in the endpoint URL. |