Quickstart — CLI + Claude Code

Full local setup with the RickyData CLI and Claude Code. Three commands to working MCP.

1. Install and initialize

npm install -g rickydata
rickydata init

The wizard opens your browser for wallet sign-in, connects to Claude Code, and verifies the connection. Restart Claude Code when prompted.

See it in action

rickydata — ~/your-project

$ npm install -g rickydata

added 42 packages in 3.1s

$ rickydata mcp connect --client claude-code

→ detecting claude-code config at ~/.claude/claude.json

✓ wrote mcpServers.rickydata

✓ registered 5,284 tools across 312 servers

$ rickydata chat erc-8004-expert "what chains are supported?"

• connecting to agent via MCP gateway...

• calling 3 tools: list_chains, get_registry, get_stats

45+ EVM chains. Base, Optimism, Arbitrum, Polygon,

and 41 others. 103,214 registered agents.

paid $0.0031 via x402 · balance $22.92 USDC

How it works

Your client

Claude Code, Cursor, SDK...

rickydata gateway

Auth · routing · x402

MCP server

Tool definitions

Tool

Live data, compute, APIs

JSON-RPC over HTTPStreaming · SSEPer-call x402 settlementSigned attestations

2. Search and enable a server

rickydata mcp search "brave"

Output shows matching servers with their IDs, tool counts, and verification status. Enable one:

rickydata mcp enable brave-search-mcp-server

3. Use it in Claude Code

Once a server is enabled, its tools are available to Claude Code. Ask Claude:

"Search the web for the latest news about MCP protocol"

Claude will call the enabled Brave Search tool directly.

CLI quick reference

# Search the marketplace (no auth needed)
rickydata mcp search "brave"

# Enable/disable servers
rickydata mcp enable brave-search-mcp-server
rickydata mcp disable brave-search-mcp-server

# List your enabled tools
rickydata mcp tools

# Call a tool directly from the CLI
rickydata mcp call blazickjp-arxiv-mcp-server__search_papers \
  '{"query":"transformers","max_results":3}'

# Check auth status and wallet balance
rickydata auth status
rickydata wallet balance

Manual Claude Code connection

If you ran rickydata auth login instead of rickydata init, connect manually:

rickydata mcp connect

Or use the dry-run flag to see the command without executing:

rickydata mcp connect --dry-run

The underlying command is:

claude mcp add --transport http mcp-gateway https://mcp.rickydata.org/mcp \
  --header "Authorization:Bearer YOUR_TOKEN"

Agent chat (BYOK)

Chat with AI agents that have access to MCP tools. Requires your own Anthropic API key:

rickydata apikey set         # Store your sk-ant-... key
rickydata agents list        # List available agents
rickydata chat erc8004-expert  # Start chatting

Chat REPL commands

Inside rickydata chat:

Command	Action
`/session`	Show current session ID
`/model <name>`	Switch model (`haiku`, `sonnet`, `opus`)
`/cost`	Show accumulated session cost
`/exit`	Exit chat

Canvas workflows

Build and execute visual workflow DAGs that chain agents, MCP tools, approval gates, and GitHub actions:

rickydata canvas list                      # List saved workflows
rickydata canvas execute <entity-id>       # Execute by ID
rickydata canvas execute ./workflow.json   # Execute local file
rickydata canvas runs                      # Check run history

claude mcp add --transport stdio canvas-workflows rickydata mcp canvas-server

How you pay for tools

Tool calls above the free tier are settled per-call via the x402 HTTP payment protocol. Here's the flow:

x402 Settlement · per-call

~600ms end-to-end

Step 1

Client → Server

Tool call, no payment

→

Step 2

402 Payment Required

Server quotes $0.003

→

Step 3

Sign transfer

Wallet signs USDC perm.

→

Step 4

Gateway settles

On Base L2 · 400ms

→

Step 5

Tool result

Signed receipt attached

Full command tree

rickydata
├── init               Setup wizard
├── auth
│   ├── login          Sign in via browser, token, or private key
│   ├── status         Auth status, token type, expiry, balance
│   ├── logout         Clear credentials
│   └── token create   Generate a wallet token
├── mcp
│   ├── search         Search marketplace servers
│   ├── enable         Enable a server
│   ├── disable        Disable a server
│   ├── tools          List tools from enabled servers
│   ├── call           Call a tool directly
│   ├── info           Get server details
│   ├── status         MCP connection status
│   ├── connect        Add MCP Gateway to Claude Code
│   └── agent
│       ├── tools      List an agent's MCP tools
│       └── call       Call an MCP tool on an agent
├── agents
│   ├── list           List available agents
│   └── describe       Show agent details
├── canvas
│   ├── list / execute / runs / run
│   ├── import / export
├── chat <agent-id>    Interactive agent chat (BYOK)
├── sessions
│   ├── list / get / resume / delete
├── wallet
│   ├── balance        USDC balance and deposit address
│   ├── transactions   Recent transactions
│   └── settings       Wallet settings
├── apikey
│   ├── set / status / delete
└── config
    ├── set / get / list / activate / profiles