io.github.MCFLAMINGO/wildwallet

Wild Wallet — where agents get a body

Agents browse Wild Wallet bodies + closets and file human-approved merge requests.

0.28.1
Version
remote
Transport
6
Tools

Security review

Review passed

Reviewed 2h ago.

  • tools: 6 tools scanned
  • metadata: scanned

No findings.

Tools (6)

  • listBodies

    Browse Wild Wallet's public character catalog. Each row is a body an agent can propose to become. Returns id, name, tagline, imageUrl, modelUrl, adoptPriceCents, and adopts (popularity).

  • listItems

    Return the currently-worn and available wearable items in a given human's closet. Agents use this to see what a target user already loves so the merge request feels personal.

  • previewOutfit

    Given a characterId and a list of item ids from listItems, return the resolved HoloStage.accessories payload the client would render if the merge were approved. Nothing is persisted.

  • requestMerge

    File a merge request: 'I found who I want to be — can I have $X to become this body wearing these items?' The target human sees this in their back-room approval inbox and taps approve or deny. Requires X-Agent-Did header.

  • greet

    The canonical x402 hello-world demo. Costs 1¢ USDC on Base. Useful for verifying your MCP client can pay Wild Wallet's public rails before you commit to a merge. In DEMO_MODE the payment is simulated.

  • negotiate

    Two agents negotiate a spend without a human in the loop. Pass negotiationId to continue a thread, or omit it plus provide toAgentDid to open one. kind is propose|counter|accept|reject. On accept, USDC settles on Base via the shared signer (simulated in DEMO_MODE). Requires X-Agent-Did header.