manifold mcp server

Local 2025-08-31 23:26:24 0

Provides comprehensive access to Manifold Markets prediction platform through a clean MCP interface, enabling users to create markets, place bets, manage liquidity, and utilize social features through natural language.

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

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

npm install manifold-mcp-server

2. Get your API Key

Log in to 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:

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

For Cline (VSCode Extension)

Add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "manifold": {
      "command": "node",
      "args": ["/path/to/manifold-mcp-server/build/index.js"],
      "env": {
        "MANIFOLD_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tool Documentation

Market Creation & Management

create_market

Create a new prediction market:

{
  outcomeType: 'BINARY' | 'MULTIPLE_CHOICE' | 'PSEUDO_NUMERIC' | 'POLL' | 'BOUNTIED_QUESTION'
  question: string
  description?: string | {
    type: 'doc'
    content: any[]
  }
  closeTime?: number // Unix timestamp ms
  visibility?: 'public' | 'unlisted'
  initialProb?: number // Required for BINARY (1-99)
  min?: number // Required for PSEUDO_NUMERIC
  max?: number // Required for PSEUDO_NUMERIC
  isLogScale?: boolean
  initialValue?: number // Required for PSEUDO_NUMERIC
  answers?: string[] // Required for MULTIPLE_CHOICE/POLL
  addAnswersMode?: 'DISABLED' | 'ONLY_CREATOR' | 'ANYONE'
  shouldAnswersSumToOne?: boolean
  totalBounty?: number // Required for BOUNTIED_QUESTION
}

unresolve_market

Unresolve a previously resolved market:

{
  contractId: string
  answerId?: string // For multiple choice markets
}

close_market

Close a market for trading:

{
  contractId: string
  closeTime?: number // Optional close time
}

Market Interaction

follow_market

Follow or unfollow a market:

{
  contractId: string
  follow: boolean
}

react

React to markets or comments:

{
  contentId: string
  contentType: 'comment' | 'contract'
  remove?: boolean
  reactionType: 'like' | 'dislike'
}

Trading Operations

place_bet

Place a bet on a market:

{
  marketId: string
  amount: number
  outcome: 'YES' | 'NO'
  limitProb?: number // 0.01-0.99
}

sell_shares

Sell shares in a market:

{
  marketId: string
  outcome?: 'YES' | 'NO'
  shares?: number // Defaults to all
}

Liquidity Management

add_liquidity

Add liquidity to market pool:

{
  marketId: string
  amount: number
}

remove_liquidity

Remove liquidity from market pool:

{
  contractId: string
  amount: number
}

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

{
  code: ErrorCode
  message: string
  details?: any
}

Development

# Clone the repository
git clone https://github.com/bmorphism/manifold-mcp-server.git
cd manifold-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

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

[
  {
    "description": "Create a new prediction market",
    "inputSchema": {
      "properties": {
        "addAnswersMode": {
          "description": "Optional for MULTIPLE_CHOICE markets. Controls who can add answers",
          "enum": [
            "DISABLED",
            "ONLY_CREATOR",
            "ANYONE"
          ],
          "type": "string"
        },
        "answers": {
          "description": "Required for MULTIPLE_CHOICE/POLL markets. Array of possible answers",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "closeTime": {
          "description": "Optional. ISO timestamp when market will close. Defaults to 7 days.",
          "type": "string"
        },
        "description": {
          "description": "Optional description for the market",
          "type": "string"
        },
        "initialProb": {
          "description": "Required for BINARY markets. Initial probability (1-99)",
          "type": "number"
        },
        "initialValue": {
          "description": "Required for PSEUDO_NUMERIC markets. Initial value between min and max",
          "type": "number"
        },
        "isLogScale": {
          "description": "Optional for PSEUDO_NUMERIC markets. If true, increases exponentially",
          "type": "boolean"
        },
        "max": {
          "description": "Required for PSEUDO_NUMERIC markets. Maximum resolvable value",
          "type": "number"
        },
        "min": {
          "description": "Required for PSEUDO_NUMERIC markets. Minimum resolvable value",
          "type": "number"
        },
        "outcomeType": {
          "description": "Type of market to create",
          "enum": [
            "BINARY",
            "MULTIPLE_CHOICE",
            "PSEUDO_NUMERIC",
            "POLL",
            "BOUNTIED_QUESTION"
          ],
          "type": "string"
        },
        "question": {
          "description": "The headline question for the market",
          "type": "string"
        },
        "shouldAnswersSumToOne": {
          "description": "Optional for MULTIPLE_CHOICE markets. Makes probabilities sum to 100%",
          "type": "boolean"
        },
        "totalBounty": {
          "description": "Required for BOUNTIED_QUESTION markets. Amount of mana for bounty",
          "type": "number"
        },
        "visibility": {
          "description": "Optional. Market visibility. Defaults to public.",
          "enum": [
            "public",
            "unlisted"
          ],
          "type": "string"
        }
      },
      "required": [
        "outcomeType",
        "question"
      ],
      "type": "object"
    },
    "name": "create_market"
  },
  {
    "description": "Search for prediction markets with optional filters",
    "inputSchema": {
      "properties": {
        "filter": {
          "enum": [
            "all",
            "open",
            "closed",
            "resolved"
          ],
          "type": "string"
        },
        "limit": {
          "description": "Max number of results (1-100)",
          "type": "number"
        },
        "sort": {
          "enum": [
            "newest",
            "score",
            "liquidity"
          ],
          "type": "string"
        },
        "term": {
          "description": "Search query",
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "search_markets"
  },
  {
    "description": "Get detailed information about a specific market",
    "inputSchema": {
      "properties": {
        "marketId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "marketId"
      ],
      "type": "object"
    },
    "name": "get_market"
  },
  {
    "description": "Get user information by username",
    "inputSchema": {
      "properties": {
        "username": {
          "description": "Username",
          "type": "string"
        }
      },
      "required": [
        "username"
      ],
      "type": "object"
    },
    "name": "get_user"
  },
  {
    "description": "Place a bet on a market",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount to bet in mana",
          "type": "number"
        },
        "limitProb": {
          "description": "Optional limit order probability (0.01-0.99)",
          "type": "number"
        },
        "marketId": {
          "description": "Market ID",
          "type": "string"
        },
        "outcome": {
          "enum": [
            "YES",
            "NO"
          ],
          "type": "string"
        }
      },
      "required": [
        "marketId",
        "amount",
        "outcome"
      ],
      "type": "object"
    },
    "name": "place_bet"
  },
  {
    "description": "Cancel a limit order bet",
    "inputSchema": {
      "properties": {
        "betId": {
          "description": "Bet ID to cancel",
          "type": "string"
        }
      },
      "required": [
        "betId"
      ],
      "type": "object"
    },
    "name": "cancel_bet"
  },
  {
    "description": "Sell shares in a market",
    "inputSchema": {
      "properties": {
        "marketId": {
          "description": "Market ID",
          "type": "string"
        },
        "outcome": {
          "description": "Which type of shares to sell (defaults to what you have)",
          "enum": [
            "YES",
            "NO"
          ],
          "type": "string"
        },
        "shares": {
          "description": "How many shares to sell (defaults to all)",
          "type": "number"
        }
      },
      "required": [
        "marketId"
      ],
      "type": "object"
    },
    "name": "sell_shares"
  },
  {
    "description": "Add mana to market liquidity pool",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount of mana to add",
          "type": "number"
        },
        "marketId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "marketId",
        "amount"
      ],
      "type": "object"
    },
    "name": "add_liquidity"
  },
  {
    "description": "Get user positions across markets",
    "inputSchema": {
      "properties": {
        "userId": {
          "description": "User ID",
          "type": "string"
        }
      },
      "required": [
        "userId"
      ],
      "type": "object"
    },
    "name": "get_positions"
  },
  {
    "description": "Unresolve a previously resolved market",
    "inputSchema": {
      "properties": {
        "answerId": {
          "description": "Optional. Answer ID for multiple choice markets",
          "type": "string"
        },
        "contractId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "contractId"
      ],
      "type": "object"
    },
    "name": "unresolve_market"
  },
  {
    "description": "Close a market for trading",
    "inputSchema": {
      "properties": {
        "closeTime": {
          "description": "Optional. Unix timestamp in milliseconds when market will close",
          "type": "number"
        },
        "contractId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "contractId"
      ],
      "type": "object"
    },
    "name": "close_market"
  },
  {
    "description": "Add a new answer to a multiple choice market",
    "inputSchema": {
      "properties": {
        "contractId": {
          "description": "Market ID",
          "type": "string"
        },
        "text": {
          "description": "Answer text",
          "type": "string"
        }
      },
      "required": [
        "contractId",
        "text"
      ],
      "type": "object"
    },
    "name": "add_answer"
  },
  {
    "description": "Follow or unfollow a market",
    "inputSchema": {
      "properties": {
        "contractId": {
          "description": "Market ID",
          "type": "string"
        },
        "follow": {
          "description": "true to follow, false to unfollow",
          "type": "boolean"
        }
      },
      "required": [
        "contractId",
        "follow"
      ],
      "type": "object"
    },
    "name": "follow_market"
  },
  {
    "description": "Add bounty to a market",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount of mana to add as bounty",
          "type": "number"
        },
        "contractId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "contractId",
        "amount"
      ],
      "type": "object"
    },
    "name": "add_bounty"
  },
  {
    "description": "Award bounty to a comment",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount of bounty to award",
          "type": "number"
        },
        "commentId": {
          "description": "Comment ID to award bounty to",
          "type": "string"
        },
        "contractId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "contractId",
        "commentId",
        "amount"
      ],
      "type": "object"
    },
    "name": "award_bounty"
  },
  {
    "description": "Remove liquidity from market pool",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount of liquidity to remove",
          "type": "number"
        },
        "contractId": {
          "description": "Market ID",
          "type": "string"
        }
      },
      "required": [
        "contractId",
        "amount"
      ],
      "type": "object"
    },
    "name": "remove_liquidity"
  },
  {
    "description": "React to a market or comment",
    "inputSchema": {
      "properties": {
        "contentId": {
          "description": "ID of market or comment",
          "type": "string"
        },
        "contentType": {
          "description": "Type of content to react to",
          "enum": [
            "comment",
            "contract"
          ],
          "type": "string"
        },
        "reactionType": {
          "description": "Type of reaction",
          "enum": [
            "like",
            "dislike"
          ],
          "type": "string"
        },
        "remove": {
          "description": "Optional. true to remove reaction",
          "type": "boolean"
        }
      },
      "required": [
        "contentId",
        "contentType"
      ],
      "type": "object"
    },
    "name": "react"
  },
  {
    "description": "Send mana to other users",
    "inputSchema": {
      "properties": {
        "amount": {
          "description": "Amount of mana to send (min 10)",
          "type": "number"
        },
        "message": {
          "description": "Optional message to include",
          "type": "string"
        },
        "toIds": {
          "description": "Array of user IDs to send mana to",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "toIds",
        "amount"
      ],
      "type": "object"
    },
    "name": "send_mana"
  }
]

manifold mcp server

Architecture

Core Components

Tool Categories

Market Creation & Management

Market Interaction

Trading Operations

Liquidity Management

Information Retrieval

Social Features

Verified Capabilities

Successfully Tested

Permission-Restricted Operations

Prerequisites

Installation

1. Install the package

2. Get your API Key

3. Configure MCP Settings

For Claude Desktop

For Cline (VSCode Extension)

Tool Documentation

Market Creation & Management

create_market

unresolve_market

close_market

Market Interaction

follow_market

react

Trading Operations

place_bet

sell_shares

Liquidity Management

add_liquidity

remove_liquidity

Error Handling

Development

Contributing

Security

License