Developer quickstart

Make your first request#

Start with a public health request. The HTTP status reports whether the app can serve requests; inspect the JSON status, problems, and db fields for dependency health.

curl https://ripper.fun/api/v1/health

Call an MCP tool#

MCP uses JSON-RPC over HTTP. For a full client connection, initialize first as shown in the MCP guide. This stateless read example returns the anonymous caller’s current entitlements.

curl https://ripper.fun/api/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_entitlements","arguments":{}}}'

Choose an interface#

Add authenticated access#

Some reads work without a key. Issue a wallet-owned API key for verified caller access on routes that support it. Wallet-signed actions still need the application’s authenticated wallet session.