Quicksilver MCP Server

Model Context Protocol (MCP) server that provides access to data sources with X402 payment support.

Features

• List Sources: Enumerate available data sources
• Get Source Schema: Retrieve schema information for specific sources
• Query Tool: Execute queries against data sources
• X402 Payments: Supports X402 protocol for paying per query

Architecture

┌─────────────┐
│   Client    │
│(e.g. Claude)│
└──────┬──────┘
       │
       │ List Sources (Free)
       │ Get Source Schema (Free)
       | Execute Query (Paid via X402)
       ▼
┌─────────────┐
│ MCP Server  │
│(Quicksilver)│
└──────┬──────┘
       │
       │ GET /api/x402/sources
       | GET /api/x402/sources/{sourceId}
       | POST /api/x402/sources/{sourceId}/query
       ▼
┌─────────────┐
│ Quicksilver │
│ Data Server │
└─────────────┘

Operations:

1. List Sources (Free): Client → MCP → Data Server
2. Get Schema (Free): Client → MCP → Data Server
3. Execute Query (Paid): Client → MCP → Data Server (with X-PAYMENT header)

Installation

Prerequisites

1. Node.js 20 or Higher

Install from the Node.js website if needed.

Verify your installation:

node --version

2. MCP-Compatible Client

Any client that supports the Model Context Protocol, such as:

• Claude Desktop
• Cursor IDE
• AI agents with MCP support

3. Wallet with USDC

• USDC on IoTeX network is required for paid query operations
• Gas (IOTX) is not required — the X402 facilitator covers gas fees
• Free operations (listing sources, retrieving schemas) work without USDC

MCP Server Configuration

This server implements the Model Context Protocol. Configuration varies by application (Claude Desktop, Cursor, etc.).

Add the following to your MCP client configuration:

{
  "mcpServers": {
    "quicksilver": {
      "command": "npx",
      "args": ["-y", "quicksilver-mcp@latest"],
      "env": {
        "RESOURCE_SERVER_URL": "https://data.iotex.ai/",
        "PRIVATE_KEY": "0x122345689....."
      }
    }
  }
}

Note: Replace PRIVATE_KEY with your actual private key for X402 payment authentication.

Useful Resources

• IoTeX Hub — Swap and bridge tokens including USDC
• USDC Contract on IoTeXScan — View USDC token details and transactions
• ioPay Wallet — Mobile wallet for managing IoTeX assets
• IoTeX Official Website — Learn more about the IoTeX ecosystem