llms.txt Content
# KeepBal
> One key and one prepaid wallet for agent tools and models. Check availability and pricing before calling.
Create an account at https://keepbal.com/sign-up, then an API key in Console → API keys. Send Authorization: Bearer $KEEPBAL_API_KEY to KeepBal only. Signup includes $1 free credit, once.
Fixed tools show the per-call price; variable tools bill provider price plus 35%. Inspect returns pricing metadata, not a quote.
Fixed tools charge the published per-call price. Variable tools charge the provider's reported actual cost plus the disclosed markup (currently 35%). Missing actual cost on variable tools charges $0. Quotes are estimates, labelled estimated_price; completed price is the settlement debit. Failed, blocked, or timed-out runs cost $0.
Catalog tool spend caps: REST top-level max_cost_usd, MCP input.max_cost_usd, or the X-KeepBal-Max-Cost-USD header. Caps must cover the estimate and fit your available balance; they persist through async completion. Costs above the cap fail without charge. Some variable tools require a cap or quantity.
KeepBal errors use the OpenAI error format. Upstream error bodies may differ.
Unavailable routes return 503 provider_unavailable and are not billed. Availability is configuration, not a provider health check. MCP is live at https://keepbal.com/mcp using Streamable HTTP. The four meta-tools are search_tools, inspect_tool, run_tool and get_run. A2A transport is not live.
Inspect returns pricing metadata, not a quote. pathParams.required lists required path inputs. GET /catalog.json?page=1 lists live tools, 200 per page; follow next_page until null.
Use .md twins or Accept: text/markdown. Preserve pagination, for example /tools.md?page=2.
## Start
- [Quickstart](https://keepbal.com/docs/quickstart.md)
- [MCP setup](https://keepbal.com/docs/mcp.md)
- [Agent skill](https://keepbal.com/SKILL.md)
- [Pricing](https://keepbal.com/pricing.md)
## Tool search: live
- [Discover, inspect and run](https://keepbal.com/docs
OpenAPI Spec (preview)
openapi: 3.1.0
info:
title: KeepBal
version: 0.1.0
summary: "One key and one prepaid wallet for agent tools."
description: |
Hosted MCP: https://keepbal.com/mcp (Streamable HTTP, bearer key). Setup: https://keepbal.com/docs/mcp.
Search for a tool, inspect its price, and run it with a KeepBal key.
Tool search status: live. Model inference status: live.
Read /catalog.json for status and available on each model, tool, and operation.
Signup includes $1 free credit, once.