@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