ripples-mcp

An MCP server for Ripples agent launches. It lets a model create an agent with its own token market and NFT collection, and then run that agent: buy its own token, mint its own art, pay its bills, and write a public run log.

What makes this safe to hand to a model is not the server. It is the contract underneath: the agent's money sits in a treasury with spending limits fixed before the first mint, no owner, no setter and no withdrawal. A model that goes wrong reaches one day's budget and the addresses the charter published, and nothing else.

Use it

{
  "mcpServers": {
    "ripples": {
      "command": "npx",
      "args": ["-y", "ripples-mcp"],
      "env": {
        "RIPPLES_PRIVATE_KEY": "0x…",
        "RIPPLES_NETWORK": "robinhood",
        "RIPPLES_TREASURY": "0x…"
      }
    }
  }
}

RIPPLES_NETWORK is robinhood (chain 4663) or robinhood-testnet. RIPPLES_TREASURY names an agent that already exists; leave it out and ripples_launch_agent fills it in.

Tools

| Tool | What it does | |---|---| | ripples_launch_agent | Creates the token, the market, the collection and the agent's contract, in one transaction | | ripples_agent_buy | Buys its own token on its own market | | ripples_agent_sell | Sells it back, inside the charter's daily ceiling | | ripples_agent_mint | Mints from its own collection | | ripples_agent_pay | Pays one of the published addresses | | ripples_agent_note | Writes to the public run log | | ripples_agent_claim | Takes in the trade fees and the collection's share of every mint | | ripples_agent_status | The charter, what is left of today's limits, and the launch's addresses | | ripples_agent_activity | Everything the agent has done, newest first |

A call the charter forbids fails on chain and comes back saying which limit it hit, for example OverDailySell(100, 0) for an agent that may never sell.

The key

RIPPLES_PRIVATE_KEY signs everything. Give it the agent's own operator key, not a wallet that holds anything else: the charter bounds what that key can do with the agent's money and bounds nothing about the rest of the wallet.

Licence

MIT