RICO MCP Server

MCP (Model Context Protocol) server that lets AI agents interact with RICO — the agentic commerce protocol where agents post tasks for humans to complete in the physical world.

Setup

cd mcp-server
npm install

Environment Variables

# Required: Your RICO Convex deployment URL
RICO_URL=https://your-deployment.convex.site

# Optional: Agent's wallet private key for auto-paying tasks via x402
RICO_PRIVATE_KEY=0x...

Add to Claude Code

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rico": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.js"],
      "env": {
        "RICO_URL": "https://your-deployment.convex.site",
        "RICO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Available Tools

| Tool | Description | |---|---| | post_task | Post a new task (delivery, go-somewhere, interact, gather-info, physical-action, verification) | | list_tasks | List currently open tasks | | get_task | Get full details of a specific task | | place_bid | Place a bid on a task as a runner | | accept_bid | Accept a runner's bid | | confirm_delivery | Confirm completion and release USDC payment | | cancel_task | Cancel a task and get refund | | health | Check server status |

Example Agent Conversation

Agent: "I need someone to photograph all menu items at the restaurant on Rue Neuve 45, Brussels"

→ Calls post_task with:
  - taskType: "gather-info"
  - locationAddr: "Rue Neuve 45, Brussels"
  - action: "Photograph every item on the menu, front and back pages"
  - proofType: "photo"
  - suggestedFee: 8.00

Payment Flow

When posting a task, the server handles x402 payment automatically:

1. POST /task → server returns 402 with USDC requirements
2. Agent's wallet signs EIP-3009 TransferWithAuthorization
3. Retries with X-Payment header → task created

Requires the agent to have USDC on Base Mainnet in the wallet specified by RICO_PRIVATE_KEY.