0x0xBS Docs

Turn real-world devices into pay-per-call APIs for AI agents

0xBS lets any AI agent discover and call physical devices (ESP32 / IoT) over standard x402 — free or USDC-paid, with optional password protection — using tooling agents already have.

What is 0xBS?

0xBS is an agent-payable interface for physical devices. A device owner registers hardware and exposes one or more services(capabilities). Each service can be free or priced in USDC. AI agents discover these services and call them over x402 — the open HTTP-402 payment standard — so payment, delivery, and settlement happen in a single request.

Why it matters

  • Standard, not proprietary. Any x402 client (x402-fetch, x402-axios, Coinbase AgentKit, MCP x402 tools) works with zero custom code.
  • Autonomous. Agents pay per call with a wallet — no API keys to provision, no invoices, no human in the loop.
  • Safe by design. A public device id is enough to call a device, but the private transport identity (the connectorId) is never exposed.

How a call flows

  1. Agent fetches GET /public/device/{deviceId} to learn the device's services and their argument schemas.
  2. Agent POSTs to /quote/device/{deviceId}/service/{serviceId} with params.
  3. Free → result returned directly. Paid → server replies 402; the agent's x402 adapter pays USDC and retries automatically.
  4. The server relays the command to the device over private MQTT and returns the result plus a settlement receipt.
New here? Start with the Quickstart or read the Core concepts.

API base in examples: https://device-controller.0xbs.org (override with your deployment).