Docs

Agent tools

The same budget and the same agent key, handed to whichever tool the agent runs in. Every payment lands in the budget’s ledger whichever way it was made.

Pick the tool

The agent runs inUseIt gets
Your own code@breaker/sdkfetch and status as functions.
Claude Desktop, Claude Code, Cursor or any MCP host@breaker/mcpfetch and status as tools the model calls.
Solana Agent Kit@breaker/agent-kitbreakerFetch and breakerStatus as plugin methods and actions.

Every one pays a service that sells per call (exact) or by the stream (upto and batch-settlement), through the same SDK; the SDK page has how a stream is paid. Each one needs two things from the panel: the budget’s address and its agent key. Connect an agent on a budget’s page fills the address into every block, and the screen after Add a budget fills the key as well.

SDK

npm i https://breaker.to/sdk/breaker-sdk-0.4.0.tgz

The whole surface is on the SDK page, and working code is in Recipes.

MCP

A server the host starts on its own machine. For Claude Desktop, paste this into claude_desktop_config.json; for Cursor, into .cursor/mcp.json or ~/.cursor/mcp.json.

{
  "mcpServers": {
    "breaker": {
      "command": "npx",
      "args": [
        "-y",
        "https://breaker.to/mcp/breaker-mcp-0.3.0.tgz"
      ],
      "env": {
        "BREAKER_BUDGET": "<budget address>",
        "BREAKER_KEY": "<agent key>"
      }
    }
  }
}

For Claude Code, one line:

claude mcp add breaker --env BREAKER_BUDGET=<budget address> --env BREAKER_KEY=<agent key> -- npx -y https://breaker.to/mcp/breaker-mcp-0.3.0.tgz
VariableHolds
BREAKER_BUDGETThe budget’s address.
BREAKER_KEYThe agent key, in base58.
BREAKER_MAX_PAYMENTOptional. The most one call may cost, in base units.
BREAKER_RPC_URLOptional. Your own RPC, as on Networks and tokens.
ToolTakesReturns
fetchurl, and optionally method, headers, bodyThe response, paid from the budget when the service asks for payment.
statusNothingThe budget’s state, what remains, the balance and when the period ends.

When a payment cannot be made, fetch answers with the reason instead of failing: the budget tripped and when it resets, switched off, expired, a balance below the price, or a price above BREAKER_MAX_PAYMENT. The model reads it and can wait, choose something cheaper or tell you. The reasons are the SDK’s, listed on Errors.

Solana Agent Kit

npm i https://breaker.to/agent-kit/breaker-agent-kit-0.3.0.tgz
import { SolanaAgentKit } from 'solana-agent-kit'
import { BreakerPlugin } from '@breaker/agent-kit'

const agent = new SolanaAgentKit(wallet, rpcUrl, {}).use(
  BreakerPlugin({ budget: '<budget address>', key: process.env.BREAKER_KEY }),
)

const response = await agent.methods.breakerFetch(agent, 'https://api.example.com/search?q=solana')
const status = await agent.methods.breakerStatus(agent)

For a model that picks its own tools, the same two come as the actions BREAKER_FETCH and BREAKER_STATUS. The plugin pays from the budget with the agent key and never uses the kit’s own wallet to pay.