Claude Code integration
What you get
Use Claude Code with KeepBal discovery, inspection and paid tool execution through one key and prepaid wallet.
Prerequisites
Create a KeepBal account and API key. Signup includes $1 credit once. Keep the key private and ensure sufficient wallet credit before executing a tool.
Setup
Install Claude Code and export KEEPBAL_API_KEY in your shell. Add the server with the command below. Local scope is the default; project and user scopes are also supported.
claude mcp add --transport http keepbal https://keepbal.com/mcp --header "Authorization: Bearer $KEEPBAL_API_KEY"
{"mcpServers":{"keepbal":{"type":"http","url":"https://keepbal.com/mcp","headers":{"Authorization":"Bearer ${KEEPBAL_API_KEY}"}}}}
Run claude mcp list or claude mcp get keepbal. In a session, open /mcp. For project configuration, use the HTTP type explicitly in .mcp.json.
Claude Code official documentation
Worked example: read a web page
Ask your agent: Find the page-content tool, inspect exa/contents, then fetch https://example.com with text enabled and summarize the result. Review the published price before approving execution. Data is from Exa; this does not imply partnership.
search_tools {"query":"page contents"}
inspect_tool {"tool":"exa/contents"}
run_tool {"tool":"exa/contents","input":{"body":{"urls":["https://example.com"],"text":true}}}
These are MCP tool names and argument objects. The client wraps them in tools/call requests. If run_tool returns pending with a run_id, call get_run {"run_id":"RETURNED_RUN_ID"}; do not repeat run_tool.
Troubleshooting
Initialization and tools/list work without a key; every tools/call requires a valid bearer key, including search and inspect. For 401 check the key and client launch environment. For insufficient_credits check Wallet; for rate_limited respect Retry-After. Check Usage after uncertain outcomes before retrying a paid call. Truncated or unsupported MCP results must not be retried.
Exa contents tool · Search and extraction tools · Errors · MCP reference · All integrations