MCP Tools

TL;DR: Start the MCP server with colter mcp, connect your MCP host, then call colter.agent.workflow or colter.check. Use colter serve when you need local HTTP protocol endpoints in addition to MCP.

Colter MCP tools return structured JSON designed for AI agents. Prefer the MCP surface when an agent needs deterministic tool calls instead of parsing prose docs.

Install

npm install -g @getcolter/cli
colter --version

MCP Setup

Claude Desktop example:

{
  "mcpServers": {
    "colter": {
      "command": "colter",
      "args": ["mcp"]
    }
  }
}

With admin tools enabled:

{
  "mcpServers": {
    "colter": {
      "command": "colter",
      "args": ["mcp", "--admin-tools"]
    }
  }
}

Manual launch:

colter mcp

Tool Families

Agent Commerce

Call colter.agent.workflow first, then follow the recommended sequence.

Tool	Purpose
colter.agent.workflow	Return the recommended call sequence
colter.agent.discover	Discover store capabilities and protocols
colter.agent.products.search	Search the product catalog
colter.agent.cart.create	Create a cart
colter.agent.cart.add	Add items to a cart
colter.agent.cart.quote	Price the current cart
colter.agent.checkout.initiate	Start checkout
colter.agent.checkout.complete	Complete or cancel checkout
colter.agent.receipt.get	Fetch the receipt

Verification

Tool	Purpose
colter.check	Fast readiness scan
colter.fix	Generate a fix plan
colter.test	Run persona-based interaction tests
colter.verify.run	Full conformance plus Evidence Pack
colter.verify.readiness	Readiness-only verification
colter.verify.report	Render a human-readable pack summary
colter.verify.diff	Compare two packs
colter.replay.run	Replay a pack
colter.pack.create	Create a pack without the full suite

Admin

These require --admin-tools.

Tool	Purpose
colter.scout	Detect platform details and generate config
colter.configure	Update configuration
colter.config.get	Read config values
colter.config.schema	Inspect valid keys and types
colter.validate	Validate configuration
colter.info	Print diagnostics

Local HTTP Runtime

Start both HTTP and MCP:

colter serve

HTTP only:

colter serve --http-only

MCP only:

colter serve --mcp-only

Custom port:

colter serve --port 8080

Typical Agent Flow

workflow -> discover -> search -> cart.create -> cart.add -> cart.quote -> checkout.initiate -> checkout.complete -> receipt.get

Security Notes

• Payment credentials are not stored in the docs flow.
• Admin tools stay behind --admin-tools.
• Evidence Packs redact sensitive values automatically.

Next Steps

• Evidence Packs
• Verify
• API Reference