Budget for your agent,
not keys to your wallet.

# budgent.py is stdlib-only (hmac + urllib) — just drop it next to your code.
from budgent import Budgent

budgent = Budgent(
    base_url="https://budgent.money",
    key_id=KEY_ID,
    hmac_secret=HMAC_SECRET,
)

r = budgent.pay(
    amount=0.01,
    domain="gpu.inference.io",
    resource="spot GPU · 1h",
    task_id="run-42",
)
print(r["status"], r.get("signature"))  # enforced on-chain

// Copy sdk/integrations/langchain/budgent_langchain.ts into your project.
import { budgentPayTool, budgentBalanceTool } from "./budgent_langchain";

const cfg = {
  baseUrl: "https://budgent.money",
  keyId: process.env.BUDGENT_KEY_ID,
  hmacSecret: process.env.BUDGENT_HMAC_SECRET,
};

const tools = [budgentPayTool(cfg), budgentBalanceTool(cfg)];
// model.bindTools(tools) — the agent pays only within the on-chain budget
// (Python: sdk/integrations/langchain/budgent_langchain.py)

// Copy sdk/integrations/openai-agents/budgent_tool.ts into your project.
import { Agent } from "@openai/agents";
import { budgentTools } from "./budgent_tool";

const { budgentPay, budgentBalance } = budgentTools({
  baseUrl: "https://budgent.money",
  keyId: process.env.BUDGENT_KEY_ID,
  hmacSecret: process.env.BUDGENT_HMAC_SECRET,
});

const agent = new Agent({
  name: "spender",
  tools: [budgentPay, budgentBalance],
});
// (Python: sdk/integrations/openai-agents/budgent_tool.py — make_budgent_tools)

# Copy sdk/integrations/crewai/budgent_crewai.py into your project.
from crewai import Agent
from budgent_crewai import budgent_tools

tools = budgent_tools(
    base_url="https://budgent.money",
    key_id=KEY_ID,
    hmac_secret=HMAC_SECRET,
)

spender = Agent(
    role="spender",
    goal="buy compute within budget",
    tools=tools,
)
# the crew member can pay — the chain enforces the budget

// Copy sdk/integrations/vercel-ai/budgent_vercel.ts into your project.
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import { budgentTools } from "./budgent_vercel";

const tools = budgentTools({
  baseUrl: "https://budgent.money",
  keyId: process.env.BUDGENT_KEY_ID,
  hmacSecret: process.env.BUDGENT_HMAC_SECRET,
});

await generateText({ model: openai("gpt-4o"), tools, prompt: "rent a GPU for an hour" });
// the model calls budgent_pay — the program enforces the budget

// Published stdio MCP server. Point any MCP host — e.g. Claude Desktop — at it:
{
  "mcpServers": {
    "budgent": {
      "command": "npx",
      "args": ["-y", "budgent-mcp"],
      "env": {
        "BUDGENT_BASE_URL": "https://budgent.money",
        "BUDGENT_KEY_ID": "your-key-id",
        "BUDGENT_HMAC_SECRET": "your-hmac-secret"
      }
    }
  }
}