waro-mcp

Servidor MCP para Waro Colombia: sustituto de waro-cli para LLM/agentes. Reutiliza los endpoints de la API de Waro (api-warolabs/api-warocol.com) y los contratos (contract.rs).

Instalación

npm install
npm run build

Related MCP server: MCP Officegest

Ejecución (stdio)

node build/index.js
# or
npm start

Inspector

npx @modelcontextprotocol/inspector node build/index.js

Configuración de MCP (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" }
    }
  }
}

Admite perfiles de ~/.waro/config.toml mediante WARO_PROFILE (igual que waro-cli/src/config.rs).

Herramientas (26)

waro_ping, waro_schema, sales_list|metrics|detail, customers_list|metrics|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

Todas las herramientas devuelven el envoltorio waro.agent.v1; los errores establecen isError:true.

Publicación

npm publish --access public

Hoja de ruta

• Lote 1: scaffold + stdio

• Lote 2: contratos de tools/list

• Lote 3: tools/call + auth + agent-json (este)