Wikicious MCP Server

Connect any MCP-compatible AI assistant (Claude Desktop, Claude Code, Cursor, VS Code Copilot, Windsurf, Kiro) directly to the Wikicious V6 protocol on Arbitrum One.

What it does

Once installed, you can ask Claude (or any MCP client):

• "What are all the active perp markets on Wikicious and their current prices?"

• "Show me all open positions for wallet 0x..."

• "What's the funding rate on ETH/USD?"

• "What's the current staking APY and my veWIK balance?"

• "Open a 5x LONG on ETH/USD with $200 collateral, stop at $2900, TP at $3200"

• "Analyze my full Wikicious portfolio for wallet 0x..."

• "What's the protocol's monthly revenue?"

Related MCP server: hyperliquid-mcp

Tools available

Read-only (no private key needed)

Write (requires WALLET_PRIVATE_KEY in .env)

Setup

1. Install

pip install -r requirements.txt
cp .env.example .env
# Edit .env: add your ARBITRUM_RPC_URL (and WALLET_PRIVATE_KEY for write tools)

For faster RPC (recommended):

ARBITRUM_RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY

2. Test it works

python server.py stdio
# In a separate terminal:
npx @modelcontextprotocol/inspector python server.py stdio

3. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "wikicious": {
      "command": "python",
      "args": ["/absolute/path/to/wikicious_mcp/server.py", "stdio"],
      "env": {
        "ARBITRUM_RPC_URL": "https://arb1.arbitrum.io/rpc",
        "WALLET_PRIVATE_KEY": "optional_for_write_tools"
      }
    }
  }
}

Restart Claude Desktop. You'll see "wikicious" appear in the tools list.

4. Add to Claude Code

claude mcp add wikicious python /absolute/path/to/wikicious_mcp/server.py stdio

5. Add to Cursor / VS Code / Windsurf

Add to your MCP settings file (varies by IDE):

{
  "wikicious": {
    "command": "python",
    "args": ["/absolute/path/to/wikicious_mcp/server.py", "stdio"]
  }
}

Security

• Read-only tools require no private key — safe to use with any wallet address

• Write tools require WALLET_PRIVATE_KEY — use a dedicated trading wallet, not your main treasury

• The MCP server runs locally on your machine — no private key leaves your computer

• Never commit .env to git

Contract addresses (Arbitrum One mainnet)