🔮 Opinion MCP Server

The Opinion MCP Server enables AI agents to interact with Opinion.trade, a prediction market platform on the BNB Chain. This server provides comprehensive access to market data, real-time pricing, order books, and user portfolio information.

By implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to discover prediction markets, analyze odds (probabilities), and track trading activity directly through their context window, bridging the gap between AI and decentralized prediction markets.

• Market Discovery: Search and filter prediction markets by status, type (binary/categorical), and keywords.
• Real-time Pricing: Access live price data, implied probabilities, and depth-of-market (order books) for any outcome token.
• Portfolio Tracking: Monitor user positions, trade history, and unrealized PnL for specific wallet addresses.
• Metadata Access: Retrieve detailed market rules, resolution criteria, and available quote tokens.

To use this server without installing it globally:

npx @iqai/mcp-opinion

git clone https://github.com/IQAIcom/mcp-opinion.git
cd mcp-opinion
pnpm install
pnpm run build

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json).

{
  "mcpServers": {
    "opinion": {
      "command": "npx",
      "args": ["-y", "@iqai/mcp-opinion"],
      "env": {
        "OPINION_API_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "opinion": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-opinion/dist/index.js"],
      "env": {
        "OPINION_API_KEY": "your_api_key_here",
        "OPINION_CHAIN_ID": "56"
      }
    }
  }
}

• "What are the trending prediction markets on Opinion right now?"
• "Search for markets related to 'Bitcoin' or 'BTC'."
• "Find active markets about the US Election."

• "Show me the order book for token 0x123... and check the spread."
• "What is the current probability implied by the price of the 'Yes' token?"
• "Get the 1-hour price history for this market token over the last 24 hours."

• "What positions am I currently holding in wallet 0xabc...?"
• "Summarize my trade history for the last month."
• "Check if I have any winning positions that need to be redeemed."

Get the current/latest trade price for a prediction market token

Get detailed information about a specific prediction market by its ID

Get a list of prediction markets from Opinion.trade with optional filters for status and market type

Get the order book (bids and asks) for a specific prediction market token

Get the current prediction market positions held by a wallet address

Get historical price data for a prediction market token

Get the list of available quote tokens (currencies) that can be used for trading on Opinion.trade

No parameters

Get the trade history for a wallet address on Opinion.trade

Search for prediction markets by keyword in the market title

pnpm run build

pnpm run watch

pnpm run lint
pnpm run format

• src/tools/: Individual tool definitions
• src/services/: API client and business logic
• src/lib/: Shared utilities
• src/index.ts: Server entry point

• Opinion.trade API Documentation
• Model Context Protocol (MCP)
• Opinion.trade Platform

This project is an unofficial tool and is not directly affiliated with Opinion.trade. It interacts with financial and prediction market data. Users should exercise caution and verify all data independently. Trading in prediction markets involves risk.

MIT