manifold

This MCP server provides a programmable interface to Manifold Markets, exposing a comprehensive set of tools for creating, managing, trading, and retrieving information about prediction markets. It maps core market operations (creation, modification, resolution, and deletion) to an MCP-style workflow, along with trading actions like placing bets, selling shares, and managing liquidity, plus social and information retrieval features such as following markets, reacting to content, and querying user data. The server is designed with a Zod-backed schema layer for validation and TypeScript for type safety, ensuring robust interactions with Manifold's REST endpoints through well-defined tool handlers.

To use it, first configure your environment with a Manifold API key and run the MCP server via the npm/npx package. Once running, you can invoke the supported operations (e.g., create_market, place_bet, add_liquidity, get_market) through the MCP interface. The server enforces role-based access controls and handles common errors gracefully, offering structured error responses and clear messaging when operations are restricted or invalid for a given market state.

Prerequisites:

• Node.js 18 or higher
• npm or yarn
• Manifold Markets API key
• Sufficient mana balance for intended operations

1. Install the MCP server package globally (or locally in your project):

# Global installation via npx (recommended for quick start)
npx -y manifold-mcp-server

2. Obtain your API key from Manifold Markets:

• Log in to Manifold Markets
• Generate an API key in your profile settings
• Ensure your account has enough mana for your intended operations

3. Configure MCP settings (example shown for Claude/Cline-style configurations):

• Create a configuration snippet (adjust the path to your environment):

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

4. Run the server (if not using npx):

# If installed locally after npm install
npx manifold-mcp-server
# Or run directly via node if you built the project
node /path/to/manifold-mcp-server/build/index.js

5. Verify the server is running by checking logs or hitting a test endpoint according to the server's documentation.

Notes and tips:

• You must supply a MANIFOLD_API_KEY in your environment to authenticate with Manifold Markets.
• The server supports a wide range of capabilities, including market creation (binary, multiple choice, pseudo-numeric, poll), trading operations (place_bet, sell_shares, cancel_bet), liquidity management (add_liquidity, remove_liquidity), and information retrieval (get_market, search_markets).
• Some operations are permission-restricted and require specific user roles (e.g., market creator for resolution/closing and bounty management).
• Ensure your Manifold account has enough mana for the actions you intend to perform because many operations require mana expenditure.
• Use the provided error handling to diagnose issues: look for validation errors, authentication failures, or permission denials, and consult the structured error response for details.