Citadelle MCP Server

An official Model Context Protocol (MCP) server for Citadelle Options - allowing AI agents (like Claude, Cursor, Windsurf) to securely interact with Citadelle options markets on the EVM / Robinhood Chain.

Features

This MCP server provides the following tools to AI Assistants:

• get_markets_liquidity: Fetches all available options markets from Citadelle and filters them by available liquidity. AI can instantly know which markets are active and ready to trade.

• get_wallet_portfolio: Fetches the open Long and Short options positions for any provided EVM wallet address.

• generate_trade_link: Safely prepares a transaction URL. Instead of having the AI sign a transaction directly (which is a security risk), the AI returns a secure deep-link to the Citadelle Web UI where the user can review and sign the transaction using their browser wallet.

Installation

You can run this server directly via npx in any compatible MCP client without installing it locally!

Configuring in Cursor / Windsurf

1. Open Settings -> MCP.

2. Add a new MCP Server.

3. Name: Citadelle

4. Command: npx

5. Args: -y citadelle-mcp@latest (To always fetch the newest bug fixes) or point directly to the local dist file: node /path/to/citadelle-mcp/dist/index.js

Configuring in Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "citadelle": {
      "command": "npx",
      "args": ["-y", "citadelle-mcp@latest"],
      "env": {
        "RPC_URL": "https://rpc.testnet.chain.robinhood.com",
        "WEB_UI_BASE_URL": "https://citadelle.com"
      }
    }
  }
}

Note for Cursor / Windsurf: You can set these environment variables directly within the MCP settings UI when adding the server.

Updating / Troubleshooting

If your AI assistant is returning outdated or incorrect market data, it may be using a cached version of the MCP Server. To force an update to the newest version:

• Claude Desktop: Quit the application completely (Cmd+Q / Ctrl+Q) and reopen it. This forces npx to check for the @latest tag.

• Cursor/Windsurf: Restart the MCP Server from the settings panel, or manually run npx clear-npx-cache in your terminal before restarting.

Local Development

1. Clone the repository and install dependencies:

   npm install

2. Create a .env file from the example:

   cp .env.example .env

3. Build the project:

   npm run build

4. Start the server locally for testing:

   npm start

Environment Variables

• RPC_URL: Your EVM RPC endpoint (default: https://rpc.testnet.chain.robinhood.com)

• WEB_UI_BASE_URL: The domain of the Citadelle Web UI for trade links (default: https://citadelle.com)

• CONTRACT_ADDRESS: The EVM address of the Citadelle Options smart contract

License

MIT