For AI Agents
Colter gives agents four launch-surface workflows: Check, Fix, Test, and Lens. Start with readiness, escalate to remediation or mystery-shopping when needed, and use the agent-commerce tool chain only after calling colter.agent.workflow.
Machine-Readable Discovery Surfaces
Use these published endpoints instead of scraping narrative docs.
| Path | Purpose |
|---|---|
| /robots.txt | Crawler access rules |
| /llms.txt | Short LLM-facing summary and routing hints |
| /llms-full.txt | Expanded inline reference for agents |
| /SKILL.md | Agent skill definitions |
| /AGENTS.md | Agent contributor and integration guide |
| /.well-known/agent.json | A2A agent card |
| /.well-known/mcp.json | MCP server discovery manifest |
| /.well-known/ucp.json | UCP service manifest |
| /openapi.yaml | Canonical OpenAPI specification |
| /mcp-tools.schema.json | Published MCP input schemas |
Recommended Routing
1. Run colter.check to determine readiness and discoverability gaps.
2. Run colter.fix when the user asks what to change on the storefront.
3. Run colter.test when the user wants to see how real AI shoppers behave across GPT, Claude, and Gemini.
4. Run colter.lens for live traffic, protocol health, drop-off analysis, and revenue impact.
5. For a configured commerce backend, call colter.agent.workflow first, then follow the returned colter.agent.* sequence.
Core MCP Tools
| Tool | Description |
|---|---|
| colter.check | Free readiness scan for any public store URL. |
| colter.fix | Generate a remediation plan with code snippets. |
| colter.test | Run AI mystery shopper simulations with 10 personas. |
| colter.lens | Inspect live AI agent traffic, drop-off, protocol health, and revenue. |
| colter.agent.workflow | Return the recommended tool sequence for agent-commerce flows. |
Agent-Commerce Tools
| Tool | Description |
|---|---|
| colter.agent.discover | Discover store capabilities and configured protocols. |
| colter.agent.products.search | Search the product catalog. |
| colter.agent.cart.create | Create a new cart. |
| colter.agent.cart.add | Add an item to a cart. |
| colter.agent.cart.quote | Quote cart totals. |
| colter.agent.checkout.initiate | Start checkout and return the next step. |
| colter.agent.checkout.complete | Complete or cancel checkout with explicit approval. |
| colter.agent.receipt.get | Fetch receipt details after checkout. |
Admin Tools
Available when the MCP server is started with --admin-tools.
| Tool | Description |
|---|---|
| colter.scout | Auto-discover store platform and generate starter config. |
| colter.configure | Apply configuration settings. |
| colter.config.get | Read the current configuration. |
| colter.config.schema | List valid config keys and types. |
| colter.validate | Validate the current configuration. |
| colter.info | Return version, runtime, and diagnostics info. |
Check Example
The default public entry point is POST /api/v1/check or colter.check.
{
"url": "https://example-store.com",
"agent_ready": true,
"fully_covered": false,
"protocols": {
"ucp": { "detected": true, "endpoint": "/.well-known/ucp", "version": "1.0", "error": "" },
"acp": { "detected": false, "endpoint": "", "version": "", "error": "/.well-known/acp returned HTTP 404" },
"mcp": { "detected": false, "endpoint": "", "version": "", "error": "Could not connect to /.well-known/mcp" }
},
"store": {
"platform": "shopify",
"platform_confidence": 0.92,
"product_count": 156,
"psp": "shopify_payments",
"detectable": true
},
"coverage": {
"google_ecosystem": true,
"openai_ecosystem": false
},
"verdict": "PARTIALLY AGENT-READY",
"recommendation": "Add ACP endpoint support for the OpenAI ecosystem",
"plain_language": {
"merchant": "Google AI can understand your store, but OpenAI-led agent checkout is still blocked."
}
}MCP Setup
{
"mcpServers": {
"colter": {
"command": "colter",
"args": ["mcp", "--admin-tools"]
}
}
}After setup, call colter.info to confirm the server is running and discover any configuration issues.
Safety And Consent
Consent: Require explicit user approval before calling colter.agent.checkout.complete with approved=true.
Idempotency: Treat checkout_id as the idempotency key for checkout completion.
Diagnostics first: If the user only needs readiness or storefront analysis, stay on colter.check, colter.fix, colter.test, or colter.lens.
Access Boundary
Everyone starts free with email + store URL and no credit card. Public Check and Fix flows do not require authentication.
Lens requires a Colter API key. Test requires at least one provider API key. Agent-commerce tools require a configured backend with store credentials in colter.yaml.