Architecture
How Bruce surfaces connect — for humans, developers, and agents.
Platform map
flowchart TB
subgraph clients [Clients]
Web[bruce.money web]
Mobile[Mobile apps]
Agents[AI agents]
Stores[Woo / Shopify]
end
subgraph edge [Edge]
Docs[docs.bruce.money]
MCP[mcp.bruce.money]
ShopifyApp[shopify-app.bruce.money]
end
subgraph core [Core]
API[api.bruce.money]
DB[(D1 / KV / DO)]
Privy[Privy wallets]
end
subgraph chain [Polygon]
USDC[USDC]
Escrow[Escrow contracts / flows]
end
Web --> API
Mobile --> API
Agents --> MCP
MCP --> API
Stores --> ShopifyApp
Stores --> API
ShopifyApp --> API
Docs -.-> Web
Docs -.-> API
API --> DB
API --> Privy
Privy --> USDC
API --> Escrow
Escrow --> USDC
Control planes
| Plane | Auth | Use |
|---|---|---|
| App session | Privy login | Human wallet & business hub UI |
| Merchant API | bk_live_… | Checkout, invoices, offerings, webhooks |
| MCP OAuth | bat_… | Agent tools with user consent |
| Agent API | bk_agent_live_… | Policy-bound agent spend |
flowchart LR Human[Human in app] --> Session[Privy session] Server[Your server] --> Key[bk_live API key] LLM[LLM client] --> MCPAuth[MCP bat_ token] Agent[Autonomous agent] --> AgentKey[bk_agent key] Session --> API[api.bruce.money] Key --> API MCPAuth --> MCP[mcp.bruce.money] MCP --> API AgentKey --> API
Compliance touchpoints
- Business KYB via Didit orchestration (Verification API).
- Webhook HMAC signatures for merchant and agent events.
- Escrow party confirmations for release/dispute paths.