Install - CostGraph Documentation

You already debug your infrastructure inside a coding agent. CostGraph’s MCP puts cost data, pricing, and recommendations right next to it.

Prerequisites

An API key from your account settings.

MCP access requires an active billing plan. Set up billing in the CostGraph platform before connecting.

Point your agent at the endpoint below, using that key.

https://mcp.costgraph.ai
X-API-Key: bl_your_key

Connect your agent

Pick your agent and drop in the config.

Codex
Claude
Amp
OpenCode
Generic

Add CostGraph to ~/.codex/config.toml:

[mcp_servers.costgraph]
url = "https://mcp.costgraph.ai"
http_headers = { "X-API-Key" = "bl_your_key" }

Run this once and Claude Code registers the server:

claude mcp add --transport http costgraph https://mcp.costgraph.ai \
  --header "X-API-Key: bl_your_key"

Add CostGraph to your Amp settings.json:

{
  "amp.mcpServers": {
    "costgraph": {
      "url": "https://mcp.costgraph.ai",
      "headers": { "X-API-Key": "bl_your_key" }
    }
  }
}

Add CostGraph to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "costgraph": {
      "type": "remote",
      "url": "https://mcp.costgraph.ai",
      "headers": { "X-API-Key": "bl_your_key" },
      "enabled": true
    }
  }
}

Generic MCP configuration. Add this to your agent’s MCP server config.

{
  "mcpServers": {
    "costgraph": {
      "url": "https://mcp.costgraph.ai",
      "headers": { "X-API-Key": "bl_your_key" }
    }
  }
}

Once it’s connected, head to Usage to put it to work.

FAQ

Can the MCP change my infrastructure?

No. CostGraph is read-only over MCP. It hands back recommendations, pricing, and your inventory. Your agent, using its own git or kubectl access, is what actually applies a change or opens a PR.

Which credential does it use?

Your bl_ API key, sent in the X-API-Key header. Every read is scoped to the tenant that key belongs to, so an agent only ever sees your own data.

What can my agent see?

Cost recommendations, live pricing, and your tenant’s inventory and metrics. See Usage for the kinds of questions that maps to.

UsageAsk your agent about cost, in plain language

​Prerequisites

​Connect your agent

​FAQ

Prerequisites

Connect your agent

FAQ