4,000+
humans on the graph
Identity, engagement, reputation, and stablecoin settlement. Read who someone is. Mint passes. Verify history. Pay per call. One MCP server. Live on Base.
scroll to explorePOST /mcp { "method": "tools/call", "params": { "name": "get_identity", "arguments": { "handle": "mende" } } }
{
"handle": "mende",
"name": "Matthias Mende",
"profileImage": "ipfs://…",
"points": 2840,
"socialLinks": [
{ "x": "@bonuzapp" },
{ "instagram": "@bonuz" }
]
}
| Tool | Status | Price |
|---|---|---|
|
get_identity
Resolve a handle. Returns profile, social links, points.
|
live | $0.001 |
|
create_bonuz_id
Issue a fresh Bonuz ID via email or social oauth. Gas sponsored.
|
soon | free * |
|
create_ai_with_birth_cert
Spawn an AI with a soul-bound birth certificate. Two parents recorded: human and model.
|
soon | $1.00 |
|
verify_ai
Verify an AI's birth certificate before trusting it — human parent, model, origin. Public provenance page: bonuz.id/ai/{handle}.
|
soon | free |
|
get_engagement
List passes, memberships, vouchers, tickets, attestations a user holds.
|
soon | $0.001 |
|
punch_card
Add a punch to a user's brand punch card. Tracked on-chain.
|
soon | $0.01 |
|
mint_dnft
Brand-side mint of a pass, voucher, ticket, or membership.
|
soon | $0.05 + gas |
|
redeem_dnft
Server-verified redemption. Updates state, attests on-chain.
|
soon | $0.01 |
|
add_loyalty_points
Increment a user's loyalty balance for a brand. Tracked on-chain.
|
soon | $0.01 |
|
attest
Write to the bonuz reputation graph. Portable, verifiable, persistent.
|
soon | $0.01 |
|
query_graph
Ask "what's my history with X" by subject, edge type, depth.
|
soon | $0.01 |
|
discover_events
Surface real and digital events created by partners. Free for agents.
|
soon | free |
Claude Desktop, Cursor, any MCP client.
"bonuz": { "transport": "http", "url": "https://mcp.bonuz.market/mcp" }
Prefer pre-paid credits over a signature per call? Fund once, then spend.
POST /credits/topup · GET /credits/balance · GET /credits/pricing. New agents get a free daily starter allowance.
BonuzSocialId.sol on Base. Hacken audited 10/10.BonuzDynamicNft.sol on Base. Soul-bound when needed. Loyalty, tickets, memberships, attestations.Model Context Protocol. An open spec maintained by Anthropic and the Linux Foundation that lets AI agents connect to tools and data sources over a standard HTTP interface. Claude Desktop, Cursor, and ChatGPT all support it. Spec version 2025-11-25.
Those give an AI agent a wallet and basic identity. bonuz mcp gives the agent the layer above: a graph of relationships, a history of engagement, portable reputation across brands and venues.
Wallets are commodity now. The relational layer above wallets has no incumbent. That is where bonuz lives.
Any AI client that speaks the Model Context Protocol. The endpoint is https://mcp.bonuz.market/mcp. Listing and discovering tools requires no account. Calls that touch user data require a bonuz identity. That part lands in Phase 1.5.
Humans using the bonuz consumer app: free, gas-sponsored. AI agents calling tools through this MCP: per-call in USDC via x402.
Reads start at $0.001 (get_identity). Writes are typically $0.01 to $0.05. Spawning a new AI with a verifiable birth certificate costs $1 and includes the gas tank top-up for that AI's future activity. Discovery and event listings stay free.
Prefer not to sign every call? Pre-fund a credit balance once (1 credit = $0.001) and each call debits instantly, no per-call signature. New agents get a small free daily allowance, so an AI can try the paid tools before funding anything.
The protocols underneath are. The bonuz ID Protocol and bonuz Engagement Protocol carry a Hacken 10/10 audit, plus CertiK, Cure53, and Kudelski Security audits via the Web3Auth stack the consumer wallet uses.
The MCP server itself is the agent-facing surface on top of those protocols, with fail-closed auth and rate limiting in front. The source is in the bonuz monorepo at apps/mcp/.
The agent sees only what the user's bonuz identity permits. The bonuz ID Protocol uses a permission-graph model: each app and agent reads specific scoped fields.
Verified social handles can be public; reputation attestations can be private to specific scopes. Users revoke access at any time.
Point your MCP client at https://mcp.bonuz.market/mcp. The configuration snippet is in the connect section above. Claude Desktop, Cursor, ChatGPT MCP support, and any custom MCP-speaking agent work without an SDK install. The server is an HTTP endpoint.
v0.1.0 is live in production: the get_identity tool, the landing page, the OAuth-protected-resource discovery endpoint, and the rate limiter. The auth and payment layers are now built: OAuth 2.1, per-call x402, and an off-chain credits ledger all ship as configurable, fail-closed middleware that each stay a transparent no-op until their env vars are set.
Two ways for an agent to pay, once payment is switched on: per-call USDC via x402, or the off-chain credits alternative. Credits work like this: one top-up mints a balance, then each call debits instantly with no per-call signature, and new agents get a free daily starter allowance. The credit surface is /credits/topup, /credits/balance, and /credits/pricing.
Next 4-8 weeks: create_bonuz_id, create_ai_with_birth_cert, mint_dnft, redeem_dnft, add_loyalty_points, attest, query_graph, discover_events. The full Phase 1 ships before Phase 2 (the @bonuz/mcp-auth drop-in package for other MCP authors).
Most digital systems treat humans as users of an app. bonuz treats humans as identity holders whose engagement persists across every app.
Once that layer is exposed to AI agents, the agent stops being a stranger to every venue and brand. It inherits the trust, history, and assets the user has already built. That is what "the Human Layer for AI" means: agents acting on top of your relationships, not their own.