Spendline

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Enforce AI budgets before the model call and track cost per customer across 10 providers.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Spendline": {
      "url": "https://www.spendline.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• spendline_when_to_use read-only

  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.

  Parameters:

  • requirement — string — The user's requirement in their own words. Optional; used to surface the closest matches first.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_list_providers read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_get_integration_instructions read-only

  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.

  Parameters:

  • document (required) — string — Which document to return.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_get_onboarding_instructions read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_check_integration_status read-only

  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.

  Parameters:

  • hours — integer — Look-back window in hours. Default 24.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_get_spend read-only

  Return spend for the current UTC month and a look-back window, optionally grouped by customer, agent, model, provider or workflow. Read-only.

  Parameters:

  • days — integer
  • limit — integer
  • group_by — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_list_budgets read-only

  Return every hierarchical budget for the account with month-to-date spend, percentage used, and whether it is in blocking (strict) mode. Read-only.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_list_policies read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_list_budget_scopes read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• spendline_create_budget

  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.

  Parameters:

  • scope_type (required) — string — org = whole account. team = tag cost-centre. agent = x-agent-id. customer = x-customer-id.
  • monthly_limit_usd (required) — number
  • confirm (required) — 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".
  • strict_mode — boolean — true blocks over-cap calls with HTTP 402. false records only.

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.