waro-mcp

MCP server for Waro Colombia — replacement for waro-cli for LLMs/agents. Reuses Waro API endpoints (api-warolabs/api-warocol.com) and contracts (contract.rs).

Install

npm install
npm run build

Related MCP server: MCP Officegest

Run (stdio)

node build/index.js
# or
npm start

Inspector

npx @modelcontextprotocol/inspector node build/index.js

MCP config (OpenCode / Claude Desktop)

{
  "mcpServers": {
    "waro-mcp": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/waro-mcp/build/index.js"],
      "env": { "WARO_API_KEY": "waro_sk_xxx", "WARO_API_URL": "https://api.warolabs.com" }
    }
  }
}

Supports ~/.waro/config.toml profiles via WARO_PROFILE (same as waro-cli/src/config.rs).

Tools (26)

waro_ping, waro_schema, sales_list|metrics|detail, customers_list|detail|orders|metrics, menu_products|recipes|modifiers, analytics_menu|food_cost|alerts|data_quality|cohort|waros|rfm|churn_risk, financial_products, waros_estimate|balances|customer, queries_schema|run

All tools return waro.agent.v1 envelope; errors set isError:true.

Publish

npm publish --access public

Roadmap

• Batch 1: scaffold + stdio

• Batch 2: tools/list contracts

• Batch 3: tools/call + auth + agent-json (this)