@smart-compost/mcp

MCP server for the Smart Compost platform. An LLM agent (Claude, Cursor, etc.) lists your processes/devices and pulls measurements as tools, using your x-api-key. Currently wraps the Integration API; named generically so more of the platform can be exposed over time.

Local stdio. Key stays on the client. The x-api-key is read from an env var and only ever leaves this process to call your own gateway. Nothing is proxied through a third party.

Tools

Six curated, read-only, workflow-oriented tools (not a 1:1 mirror of every endpoint). Discovery comes first so the agent can find IDs before asking for data. The server also ships top-level instructions telling the model to start with discovery.

| Tool | Endpoint | Purpose | | --- | --- | --- | | list_processes | GET /processes | Discover processes (with nested devices) | | list_devices | GET /devices | Discover device ids | | get_latest_device_readings | GET /data/{deviceId} | Quick poll, 5 most recent | | get_latest_process_readings | GET /data/process/{processId} | Quick poll per process | | get_device_measurements | GET /devices/{deviceId}/measurements | History, paginated | | get_process_measurements | GET /processes/{processId}/measurements | History, all devices |

Install

Add it in one line, no clone or build:

claude mcp add smart-compost \
  -e SMARTCOMPOST_API_KEY=sk_live_xxx \
  -- npx -y @smart-compost/mcp

Cursor / Windsurf / Claude Desktop (mcp.json):

{
  "mcpServers": {
    "smart-compost": {
      "command": "npx",
      "args": ["-y", "@smart-compost/mcp"],
      "env": { "SMARTCOMPOST_API_KEY": "sk_live_xxx" }
    }
  }
}

Config:

• SMARTCOMPOST_API_KEY (required): your Integration API key (sk_live_...), generated on the Integrations page.
• SMARTCOMPOST_API_BASE (optional): defaults to https://test.smart-compost.com.br/api. Use https://smart-compost.com.br/api for production.

Then ask the agent things like "list my composting processes" or "show the latest readings for device 666".

License

Apache-2.0