The stdio server proxies tools to the REST API using your ingest key.

​
Env

VariableDefaultRequired
COSTMCP_API_URLhttp://localhost:3000
COSTMCP_API_KEY—✓

​
Run

pnpm mcp:dev

​
Cursor config

{
  "mcpServers": {
    "costmcp": {
      "command": "pnpm",
      "args": ["mcp:dev"],
      "cwd": "/absolute/path/to/costmcp",
      "env": {
        "COSTMCP_API_URL": "http://localhost:3000",
        "COSTMCP_API_KEY": "cmcp_live_..."
      }
    }
  }
}
Also see examples/cursor-mcp-config.json in the repo. For hosted agents, use https://mcp.costmcp.com instead of stdio.

​
Tools

Same as MCP tools except get_monthly_summary is not available on stdio — use GET /api/v1/summary/month or remote MCP.