Manifold Markets MCP Server
An MCP server for interacting with Manifold Markets prediction markets. This server provides comprehensive access to Manifold's features through a clean MCP interface, enabling sophisticated market interactions and collective intelligence mechanisms.
Architecture
The server implements a complete mapping of Manifold Markets' API capabilities through a structured tool system:
Core Components
- **Schema Layer**: Zod-based validation schemas for all operations
- **API Integration**: Direct mapping to Manifold's REST endpoints
- **Tool Handlers**: Request processing with proper error management
- **Type Safety**: Full TypeScript implementation
Tool Categories
Market Creation & Management
- `create_market`: Create markets (BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, POLL)
- `unresolve_market`: Revert resolved markets
- `close_market`: Close markets for trading
- `add_answer`: Add options to multiple choice markets
Market Interaction
- `follow_market`: Track markets of interest
- `react`: Like/dislike markets and comments
- `add_bounty`: Add bounties for analysis
- `award_bounty`: Reward valuable contributions
Trading Operations
- `place_bet`: Execute market trades
- `cancel_bet`: Cancel limit orders
- `sell_shares`: Liquidate positions
Liquidity Management
- `add_liquidity`: Provide market liquidity
- `remove_liquidity`: Withdraw provided liquidity
Information Retrieval
- `search_markets`: Find markets with filters
- `get_market`: Detailed market information
- `get_user`: User profile data
- `get_positions`: Portfolio tracking
Social Features
- `send_mana`: Transfer mana between users
Verified Capabilities
The server has been tested through comprehensive interaction trajectories:
Successfully Tested
- Market Discovery & Following - Market search with filters - Market following - Detailed market information retrieval
- Trading Operations - Liquidity provision - Bet placement with probability updates - Position liquidation - Share selling
- Permission Management - Role-based access control - Authentication handling - Error messaging
Permission-Restricted Operations
These operations are implemented but require specific user roles:
- Market resolution/unresolving (market creator)
- Market closing (market creator)
- Bounty management (market creator)
- Liquidity removal (liquidity provider)
Prerequisites
- Node.js 18 or higher
- npm or yarn
- Manifold Markets API key
- Minimum M$1000 balance for market creation
Installation
1. Install the package
2. Get your API Key
- Log in to [Manifold Markets](https://manifold.markets)
- Go to your profile settings
- Generate an API key
- Ensure account has sufficient mana for intended operations
3. Configure MCP Settings
For Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
For Cline (VSCode Extension)
Add to `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:
Tool Documentation
Market Creation & Management
create_market
Create a new prediction market:
unresolve_market
Unresolve a previously resolved market:
close_market
Close a market for trading:
Market Interaction
follow_market
Follow or unfollow a market:
react
React to markets or comments:
Trading Operations
place_bet
Place a bet on a market:
sell_shares
Sell shares in a market:
Liquidity Management
add_liquidity
Add liquidity to market pool:
remove_liquidity
Remove liquidity from market pool:
Error Handling
The server implements comprehensive error handling:
- Input Validation - Parameter type checking via Zod schemas - Value range validation - Required field verification
- API Communication - Authentication errors - Network failures - Rate limiting - Permission checks
- Business Logic - Insufficient balance - Invalid market states - Unauthorized operations
- Error Response Format
Development
Contributing
Contributions welcome! Areas of interest:
- Advanced market analysis tools
- Portfolio optimization features
- Integration with other prediction platforms
- Documentation improvements
Security
- API keys handled via environment variables
- Input validation on all parameters
- Rate limiting protection
- Safe error messages
- Role-based access control
License
MIT