Connect your own MCP client

Aristotle’s in-app chat is the easy way in. When you want more — your own LLM budget, your own tooling, or to wire WattCarbon data into an assistant you already use — you can point your own MCP client straight at WattCarbon’s endpoint. You bring the language model and pay for its tokens; we serve your account’s data, read-only.

The endpoint

https://api.wattcarbon.com/mcp

It speaks the streamable-http MCP transport and authenticates with a short-lived WattCarbon API token (the same token the rest of our API uses). Everything it exposes is read-only and scoped to your account — exactly what Aristotle can see, nothing it can’t.

Get an API token

You need a WattCarbon API key first. API keys are not self-serve — contact WattCarbon to have one issued for your account. Once you have it, exchange it for a token at /auth/token:

curl -s -X POST https://api.wattcarbon.com/auth/token \
  -d "username=YOUR_EMAIL&password=YOUR_API_KEY" \
  | jq -r .access_token

username is the email on your account; password is the API key. Tokens expire after 1 day — regenerate when needed. Direct-MCP clients are expected to cycle their own tokens.

Configure your client

Add WattCarbon to your MCP client’s server list. For Claude Desktop, Cursor, and most other clients the shape is:

{
  "mcpServers": {
    "wattcarbon": {
      "type": "streamable-http",
      "url": "https://api.wattcarbon.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Then ask your assistant things like “What assets do I have?”, “Explain the methodology for asset 42”, or “Show me last year’s monthly savings for my solar fleet.”

Available tools

All tools are read-only.

Tool	What it does
`get-account`	Your account overview and contact info.
`list-assets`	List your assets, with optional kind / status / domain / name filters.
`get-asset`	Full configuration, location, and metadata for one asset.
`get-asset-methodology`	Start here. How an asset is measured: methodology steps, model details, and carbon / grid scores.
`get-asset-measurement-logs`	Scores, warnings, and data-quality notes from an asset’s latest measurement job.
`get-asset-measurements`	An asset’s measurement timeseries (observed vs. comparison scenario) as chartable data points.
`get-measurement-summary`	Available date ranges and measurement scenarios for your assets — call this before measurements or methodology to discover what data exists.
`list-docs`	Index of WattCarbon platform how-to documentation.
`get-doc`	The full text of a platform documentation page.