Manifold MCP Server

🚀 MCP Server for Manifold Market

An MCP server for interacting with the Manifold market prediction market. This server provides comprehensive access to the Manifold market's features through a simple MCP interface and supports various tools and services.

🚀 Quick Start

Deployment Steps

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

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

✨ Features

Disassembled Architecture

The server is built based on the modular and scalable design concept. The main components include:

• Core Control Module: Responsible for handling basic commands and protocols.
• Market Data Module: Manages all market information and transaction data.
• User Interaction Module: Handles requests and instructions from clients.
• Security Verification Module: Ensures the security and compliance of all operations.

Core Components

1. Zod Validation Schema
   • All input parameters undergo strict type checking and value range validation.
   • Clear data structures are defined using the Zod library.
   • Ensures the legitimacy of API requests.
2. Market Data Processing
   • Supports multi - chain deployment and cross - platform transactions.
   • Provides real - time market monitoring and data analysis.
   • Automatically generates market reports and statistical information.
3. Protocol Execution Engine
   • Responsible for handling complex market operation logic.
   • Ensures that all transactions are executed correctly according to the rules.
   • Provides complete transaction log records.

Tool Categories

Market Interaction Tools

1. Create a New Market

{
  title: string
  description: string
  marketType: "prediction" | "binary" | "custom"
  parameters: {
    [key: string]: any
  }
}

2. Query Market Information

{
  contractId: string
  fields?: string[]
}

3. Modify an Existing Market

{
  contractId: string
  updates: {
    [key: string]: any
  }
}

Market Operation Tools

1. Place a Bet

{
  marketId: string
  amount: number
  outcome: "YES" | "NO"
  prob?: number
}

2. Transfer Shares

{
  marketId: string
  recipient: string
  shares: number
}

3. Cancel an Order

{
  orderId: string
  cancellationReason?: string
}

Error Handling

1. Input Validation
   • All parameters undergo strict type checking.
   • Ensures that numerical values are within the valid range.
   • Validates the existence of required fields.
2. API Call Errors
   • Catches all network exceptions and API errors.
   • Provides detailed error information.
   • Implements a retry mechanism to ensure reliability.
3. Business Logic Errors
   • Checks the market status and user permissions.
   • Prevents the execution of invalid operations.
   • Ensures the security of funds and the legitimacy of transactions.
4. Error Response Format

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

📚 Documentation

Contribution Guidelines

Contributions are welcome! Here are several key directions:

• Develop advanced market analysis tools.
• Implement portfolio optimization features.
• Promote integration with other prediction platforms.
• Improve the quality of documentation.

Security Precautions

• All API keys are managed through environment variables.
• Input parameters are strictly validated.
• Rate limiting protection is implemented.
• Error information is kept secure.
• Role - based access control is adopted.

📄 License

MIT License