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?"

Tools available

Read-only (no private key needed)

Tool	Description
wikicious_get_markets	All active perp markets + mark prices
wikicious_get_price	Oracle price for any market
wikicious_get_vault_balance	USDC vault balance for a wallet
wikicious_get_positions	All open perp positions for a wallet
wikicious_get_position	Specific position with on-chain PnL
wikicious_get_funding_rate	Funding rate + OI imbalance
wikicious_get_lending_rates	Supply/borrow APY for lending markets
wikicious_get_lending_position	User's lending position
wikicious_get_staking_info	Staking lock, veWIK, claimable fees
wikicious_get_amm_stats	WikiAMM AUM + WLP price
wikicious_get_wik_balance	WIK token balance
wikicious_get_revenue_stats	Protocol monthly fees + revenue split
wikicious_get_protocol_summary	Full protocol health snapshot

Write (requires WALLET_PRIVATE_KEY in .env)

Tool	Description
wikicious_open_position	Open perp position with TP/SL
wikicious_close_position	Close an open position
wikicious_deposit_vault	Deposit USDC into WikiVault
wikicious_withdraw_vault	Withdraw USDC from WikiVault
wikicious_stake_wik	Stake WIK with lock duration
wikicious_claim_staking_fees	Claim USDC fee rewards

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)

Contract	Address
WikiPerp	0x723f653a3DEFC45FB934BBF81f1411883a977468
WikiVault	0x4533E181FdF5b0C66e0816992F38c23d57e42Df8
WikiOracle	0xA99583D3cd272F95b8f08b32297f072f5164D0DC
WikiStaking	0xDD551D705fAbD4380D2C95F7345b671cE3310bd2
WikiAMM	0x5e73fa11c2Fa157dbE59E7B8F7f1b3101c5c6004
WikiLending	0x74635CFa33EEAe220367fF10C598e098a29e9246
WIK Token	0xa681Bf6f0449ABc4E98DCa3468488Fe1b24FdD0F