Spendline

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.

{
  "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
}

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.

{
  "type": "object",
  "properties": {},
  "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.

{
  "type": "object",
  "properties": {
    "document": {
      "type": "string",
      "enum": [
        "index",
        "when-to-use",
        "quickstart",
        "openai",
        "anthropic",
        "providers",
        "attribution",
        "budgets",
        "hierarchical-budgets",
        "policies",
        "rerouting",
        "keys",
        "verification",
        "troubleshooting",
        "onboarding",
        "connect"
      ],
      "description": "Which document to return."
    }
  },
  "required": [
    "document"
  ],
  "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.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

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.

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720,
      "default": 24,
      "description": "Look-back window in hours. Default 24."
    }
  },
  "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.

{
  "type": "object",
  "properties": {
    "group_by": {
      "type": "string",
      "enum": [
        "customer",
        "agent",
        "model",
        "provider",
        "workflow",
        "none"
      ],
      "default": "none"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "default": 30
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "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.

{
  "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.

{
  "type": "object",
  "properties": {},
  "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.

{
  "type": "object",
  "properties": {},
  "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.

{
  "type": "object",
  "properties": {
    "scope_type": {
      "type": "string",
      "enum": [
        "org",
        "team",
        "agent",
        "customer"
      ],
      "description": "org = whole account. team = tag cost-centre. agent = x-agent-id. customer = x-customer-id."
    },
    "scope_id": {
      "type": "string",
      "description": "Required unless scope_type is \"org\"."
    },
    "monthly_limit_usd": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "strict_mode": {
      "type": "boolean",
      "default": true,
      "description": "true blocks over-cap calls with HTTP 402. false records only."
    },
    "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."
    }
  },
  "required": [
    "scope_type",
    "monthly_limit_usd",
    "confirm"
  ],
  "additionalProperties": false
}