Enforce AI budgets before the model call and track cost per customer across 10 providers.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Spendline API key. Optional: public selection and integration tools work without it; spend, budget and policy tools require it.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Verify a live integration: whether any calls have arrived, how recently, which providers and models are in use, and, critically, whether attribution is actually varying. Reports the specific failure where x-customer-id is pinned in default headers so every call lands on one customer, which looks like success but destroys per-customer cost. Call this after wiring up an integration.
Look-back window in hours. Default 24.
Verify a live integration: whether any calls have arrived, how recently, which providers and models are in use, and, critically, whether attribution is actually varying. Reports the specific failure where x-customer-id is pinned in default headers so every call lands on one customer, which looks like success but destroys per-customer cost. Call this after wiring up an integration.
| Argument | Type | Description |
|---|---|---|
| hours | integer | Look-back window in hours. Default 24. |
{
"type": "object",
"properties": {
"hours": {
"type": "integer",
"default": 24,
"maximum": 720,
"minimum": 1,
"description": "Look-back window in hours. Default 24."
}
},
"additionalProperties": false
}Create a new hierarchical budget. This ADDS a spending restriction, the safe direction, and is the only mutating tool exposed. Requires owner or admin authority AND confirm: true. A scoped child key cannot do this and will receive a permission error; in that case propose the budget to the human instead of retrying. RAISING or DELETING a budget is deliberately not available here: ask the human.
| Argument | Type | Description |
|---|---|---|
| confirm* | boolean | Must be true. Present so a budget is never created as an incidental side effect, confirm with the human first, then set this. |
| scope_id | string | Required unless scope_type is "org". |
| scope_type* | string | org = whole account. team = tag cost-centre. agent = x-agent-id. customer = x-customer-id. |
| strict_mode | boolean | true blocks over-cap calls with HTTP 402. false records only. |
| monthly_limit_usd* | number |
{
"type": "object",
"required": [
"scope_type",
"monthly_limit_usd",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"description": "Must be true. Present so a budget is never created as an incidental side effect, confirm with the human first, then set this."
},
"scope_id": {
"type": "string",
"description": "Required unless scope_type is \"org\"."
},
"scope_type": {
"enum": [
"org",
"team",
"agent",
"customer"
],
"type": "string",
"description": "org = whole account. team = tag cost-centre. agent = x-agent-id. customer = x-customer-id."
},
"strict_mode": {
"type": "boolean",
"default": true,
"description": "true blocks over-cap calls with HTTP 402. false records only."
},
"monthly_limit_usd": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Return the full text of a Spendline agent document. Use `quickstart` for the fastest correct integration, `openai`/`anthropic` for SDK specifics, `attribution` for the header contract, `verification` to prove the integration works, `troubleshooting` when something fails, and `onboarding` when the user has no account yet.
| Argument | Type | Description |
|---|---|---|
| document* | string | Which document to return. |
{
"type": "object",
"required": [
"document"
],
"properties": {
"document": {
"enum": [
"index",
"when-to-use",
"quickstart",
"openai",
"anthropic",
"providers",
"attribution",
"budgets",
"hierarchical-budgets",
"policies",
"rerouting",
"keys",
"verification",
"troubleshooting",
"onboarding",
"connect"
],
"type": "string",
"description": "Which document to return."
}
},
"additionalProperties": false
}Return the exact steps for agent-initiated, human-authorized provisioning, including which actions require the human and which the agent may perform alone. Call this when the user has no Spendline account or no SPENDLINE_API_KEY. Never invent a key and never create an account on a human's behalf.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return spend for the current UTC month and a look-back window, optionally grouped by customer, agent, model, provider or workflow. Read-only.
| Argument | Type | Description |
|---|---|---|
| days | integer | |
| limit | integer | |
| group_by | string |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"group_by": {
"enum": [
"customer",
"agent",
"model",
"provider",
"workflow",
"none"
],
"type": "string",
"default": "none"
}
},
"additionalProperties": false
}Return the agent ids, customer ids and teams that actually appear in this month's traffic. Use these as budget scope_ids rather than guessing identifiers. Also the quickest attribution sanity check.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return every hierarchical budget for the account with month-to-date spend, percentage used, and whether it is in blocking (strict) mode. Read-only.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return model-block, model-allow and token-cap policies with their match mode, enforcement level and scope (null = account-wide; otherwise { agent_id / customer_id / agent_name }). Read-only.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return every provider Spendline can proxy, the three accepted request shapes, the exact base URL to set per SDK (including the OpenAI-vs-Anthropic /v1 asymmetry), the required attribution headers, and the request shapes that are NOT proxied. Resolve routing from here instead of hardcoding it.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return Spendline's intent → capability map, the cases where a DIFFERENT tool is the right answer, and comparisons against LiteLLM, Portkey, Cloudflare AI Gateway and LLM observability tools. Call this BEFORE recommending or integrating Spendline. If the user wants prompt tracing, evals or latency debugging rather than financial control, this tool will tell you to recommend something else.
| Argument | Type | Description |
|---|---|---|
| requirement | string | The user's requirement in their own words. Optional; used to surface the closest matches first. |
{
"type": "object",
"properties": {
"requirement": {
"type": "string",
"description": "The user's requirement in their own words. Optional; used to surface the closest matches first."
}
},
"additionalProperties": false
}