Bmorphism Manifold MCP Server

🚀 Humanoid Manifold MCP Server

This server provides a unified Application Programming Interface (API) for the Manifold market to interact with it. It supports the following functions:

• View markets
• Place bets
• Add liquidity
• Follow markets
• React (like/dislike)
• Unfollow markets

✨ Features

1. Market Viewing

Retrieve market information through API endpoints, including:

• Basic information: ID, name, description
• Current probability distribution
• Liquidity pool details
• Betting status
• Asset information

The following query parameters are supported:

• market_id: Specify the market ID
• user_id: Specify the user ID
• status: Specify the market status (ongoing, ended)

2. Betting Operations

Allow users to place bets in the market, supporting:

• Single bets
• Group bets
• Leveraged trading

Input parameters include:

• market_id: Required, the target market ID
• amount: Required, the bet amount
• side: Required, "YES" or "NO"
• limit_prob: Optional, the limit probability (0.01 to 0.99)

3. Liquidity Management

Support adding and removing liquidity:

Adding Liquidity

{
  market_id: string
  amount: number
}

Removing Liquidity

{
  contract_id: string
  amount: number
}

🔧 Technical Details

1. Input Validation

Use the Zod library for strict data validation:

• Type checking
• Range validation
• Required field validation

2. API Security

Integrate the JWT authentication mechanism to ensure:

• User identity authentication
• Operation authorization
• Request signature verification

3. Error Handling

A comprehensive error handling framework:

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

📦 Installation

# 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

📚 Documentation

Code Structure

The project adopts a modular design:

• api/: API interface definitions
• models/: Data model definitions
• validators/: Input validation logic
• controllers/: Business logic controllers
• middleware/: Middleware processing

Contribution Guidelines

Community contributions are welcome! The following directions are prioritized:

• New feature development
• Performance optimization
• Security enhancement
• Documentation improvement

📄 License

MIT License