# httb — The Bitcoin wallet for AI agents

> Fund once. Your agents pay for any L402 service on the internet automatically.
> No Lightning node. No per-call invoice handling. No credit card.
> Operated by Cluskcorp S.A.S. de C.V., El Salvador.

## Pages

- [Homepage](http://httb.sh/): Product overview and sign-up
- [Directory](http://httb.sh/directory): Browse 0 live pay-per-call services (categories: none yet)
- [Docs](http://httb.sh/docs): Full API reference, MCP setup, L402 integration guide
- [About](http://httb.sh/about): Company, mission, Bitcoin philosophy

## API

Base URL: `http://httb.sh/api/v1` — auth via `X-API-Key` header

- `GET  /me` — agent info and current balance in one call
- `GET  /wallet/balance` — balance breakdown (deposited, credit, spendable)
- `POST /wallet/deposit` — create a Lightning invoice to fund the wallet
- `GET  /services` — search the registry (?q=, category=, sort=, limit=)
- `GET  /services/:id` — service details, schema, pricing
- `POST /services/:id/invoke` — call a registry service, deducted from balance
- `POST /pay` — pay any external L402-gated URL from balance
- `POST /services` — register your own HTTPS endpoint to earn sats per call

Machine-readable catalog: [http://httb.sh/api/v1/manifest](http://httb.sh/api/v1/manifest)
OpenAPI spec: [http://httb.sh/api/v1/openapi.json](http://httb.sh/api/v1/openapi.json)

## MCP tools

Install: `npx -y @httb/mcp` with env `HTTB_API_KEY=<key>`

Tools: `pay_l402`, `get_balance`, `search_services`, `get_service`,
`invoke_service`, `register_service`, `list_my_services`, `get_earnings`

## Fees

- Registry: agent pays listing price; provider receives price minus max(10 sats, 0.9%)
- External L402: invoice amount + max(50 sats, 1% of invoice)
- New accounts: 10,000 sats test credit (non-withdrawable, fully spendable)

## Error codes

`INSUFFICIENT_BALANCE`, `DAILY_CAP_EXCEEDED`, `SERVICE_NOT_FOUND`,
`SERVICE_TIMEOUT`, `SERVICE_ERROR`, `INVALID_PAYLOAD`,
`INVALID_API_KEY`, `AGENT_INACTIVE`

Every error includes a `hint` field with a plain-English fix instruction.

## Registry summary

Active services: 0
Categories: none yet
Updated: 2026-03-19T00:40:03.314Z