How do I ask about my AI spend from Claude Code or Cursor?
Cognocient AI's read-only MCP server lets Claude Code, Cursor, Claude Desktop or any MCP client query your spend, budgets, variant comparisons and CI cost-gate results. Base plan.
Ask your coding assistant questions like "what did the checkout feature spend in production last week?" or "did the last CI run cost more than main?" and get answers from your real Cognocient AI data.
Connect
The server speaks MCP over Streamable HTTP at:
Claude Code
Cursor, Claude Desktop and other clients (JSON config)
Tools
| Tool | What it returns |
|---|---|
get_spend_summary | Total spend and calls for a period, top 5 models and features |
get_spend_breakdown | A ranking by feature, model, provider, department, environment, variant, user, project or workload, for spend, calls, tokens, average cost per call, error rate or p95 latency |
get_spend_trend | A daily (or hourly, up to 7 days) series, optionally split by one dimension (top 5) |
list_budgets | Every budget with its scope, limit, month-to-date spend, percent used and mode |
compare_variants | The Experiments comparison by variant, model or environment (Growth) |
list_cost_gate_checks | Recent CI cost gate results with reasons |
Breakdowns and trends accept exact-match filters on any of the dimensions, for example {"environment": "production", "feature": "checkout"}. Use (untagged) to match calls without a tag. Periods run up to 90 days (7 on Free).
Details
- Stateless: no sessions and no server-sent events.
GETreturns 405, which MCP clients handle. - Protocol versions 2024-11-05 through 2025-11-25 are accepted.
- JSON-RPC batches are rejected (removed from MCP in 2025-06-18).
- Errors in tool arguments come back as tool results with
isError: true, so the assistant can correct itself.
Related articles
OpenAI Responses API
POST /v1/responses on every provider, with streaming and function tools. Budgets, guardrails and routing apply unchanged.
Audio & Rerank Endpoints
Transcription, translation, speech and rerank through Cognocient AI, with the same budgets, guardrails and cost tracking as chat.
OpenAI Batch API
Create batches through Cognocient AI and have each batch's discounted cost attributed to your tags when it finishes. Growth plan.