bz bonuz mcp
phase 1 · v0.0.1

The Human Layer.
For AI.

Identity, engagement, reputation, and stablecoin settlement. Read who someone is. Mint passes. Verify history. Pay per call. One MCP server. Live on Base.

request
POST /mcp
{
  "method": "tools/call",
  "params": {
    "name": "get_identity",
    "arguments": { "handle": "mende" }
  }
}
response
{
  "handle": "mende",
  "name": "Matthias Mende",
  "profileImage": "ipfs://…",
  "points": 2840,
  "socialLinks": [
    { "x": "@bonuzapp" },
    { "instagram": "@bonuz" }
  ]
}
01

tools

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
get_engagement
List passes, memberships, vouchers, tickets, attestations a user holds.
soon $0.005
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
* Free for humans. Gas sponsored from the bonuz gas tank. AI creation costs $1 USDC, paid via x402.
02

connect

https://mcp.bonuz.market/mcp

Claude Desktop, Cursor, any MCP client.

"bonuz": {
  "transport": "http",
  "url": "https://mcp.bonuz.market/mcp"
}
OAuth 2.1 and x402 payment middleware land in phase 1.5. Health: /healthz.
03

under the hood

Identity
bonuz ID Protocol. BonuzSocialId.sol on Base. Hacken audited 10/10.
Engagement
bonuz Engagement Protocol. BonuzDynamicNft.sol on Base. Soul-bound when needed. Loyalty, tickets, memberships, attestations.
Payment
USDC via x402. Coinbase facilitator at launch. Self-hosted reputation-aware facilitator in phase 3.
Auth
OAuth 2.1 against the existing Bonuz ID JWT issuer. RFC 9728 protected resource metadata.
Spec
MCP 2025-11-25. Streamable HTTP transport. Tools, resources, prompts, completions.
Operator
Protocols by Bonuz Inc. (St. Lucia). Apps and SDK by Bonuz Technology DMCC (Dubai).
04

numbers

4,000+
humans on the graph
10/10
hacken audit score
44
chains supported
4.8
app store rating