{"id":25368582,"url":"https://github.com/bmorphism/manifold-mcp-server","last_synced_at":"2025-07-16T05:08:53.429Z","repository":{"id":271699851,"uuid":"914300436","full_name":"bmorphism/manifold-mcp-server","owner":"bmorphism","description":"MCP server for interacting with Manifold Markets prediction markets","archived":false,"fork":false,"pushed_at":"2025-01-11T10:36:58.000Z","size":35,"stargazers_count":6,"open_issues_count":6,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-05T07:59:27.944Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bmorphism.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-09T10:28:08.000Z","updated_at":"2025-06-17T09:13:22.000Z","dependencies_parsed_at":"2025-01-09T11:33:02.822Z","dependency_job_id":null,"html_url":"https://github.com/bmorphism/manifold-mcp-server","commit_stats":null,"previous_names":["bmorphism/manifold-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bmorphism/manifold-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmorphism%2Fmanifold-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmorphism%2Fmanifold-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmorphism%2Fmanifold-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmorphism%2Fmanifold-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmorphism","download_url":"https://codeload.github.com/bmorphism/manifold-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmorphism%2Fmanifold-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265483546,"owners_count":23774225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-15T00:39:14.003Z","updated_at":"2025-07-16T05:08:53.408Z","avatar_url":"https://github.com/bmorphism.png","language":"JavaScript","funding_links":[],"categories":["Task and Project Management","Finance \u0026 Fintech","Finance \u0026 Market Data Mcp Servers"],"sub_categories":["How to Submit"],"readme":"# Manifold Markets MCP Server\n\nAn 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.\n\n## Architecture\n\nThe server implements a complete mapping of Manifold Markets' API capabilities through a structured tool system:\n\n### Core Components\n- **Schema Layer**: Zod-based validation schemas for all operations\n- **API Integration**: Direct mapping to Manifold's REST endpoints\n- **Tool Handlers**: Request processing with proper error management\n- **Type Safety**: Full TypeScript implementation\n\n### Tool Categories\n\n#### Market Creation \u0026 Management\n- `create_market`: Create markets (BINARY, MULTIPLE_CHOICE, PSEUDO_NUMERIC, POLL)\n- `unresolve_market`: Revert resolved markets\n- `close_market`: Close markets for trading\n- `add_answer`: Add options to multiple choice markets\n\n#### Market Interaction\n- `follow_market`: Track markets of interest\n- `react`: Like/dislike markets and comments\n- `add_bounty`: Add bounties for analysis\n- `award_bounty`: Reward valuable contributions\n\n#### Trading Operations\n- `place_bet`: Execute market trades\n- `cancel_bet`: Cancel limit orders\n- `sell_shares`: Liquidate positions\n\n#### Liquidity Management\n- `add_liquidity`: Provide market liquidity\n- `remove_liquidity`: Withdraw provided liquidity\n\n#### Information Retrieval\n- `search_markets`: Find markets with filters\n- `get_market`: Detailed market information\n- `get_user`: User profile data\n- `get_positions`: Portfolio tracking\n\n#### Social Features\n- `send_mana`: Transfer mana between users\n\n## Verified Capabilities\n\nThe server has been tested through comprehensive interaction trajectories:\n\n### Successfully Tested\n1. Market Discovery \u0026 Following\n   - ✅ Market search with filters\n   - ✅ Market following\n   - ✅ Detailed market information retrieval\n\n2. Trading Operations\n   - ✅ Liquidity provision\n   - ✅ Bet placement with probability updates\n   - ✅ Position liquidation\n   - ✅ Share selling\n\n3. Permission Management\n   - ✅ Role-based access control\n   - ✅ Authentication handling\n   - ✅ Error messaging\n\n### Permission-Restricted Operations\nThese operations are implemented but require specific user roles:\n- Market resolution/unresolving (market creator)\n- Market closing (market creator)\n- Bounty management (market creator)\n- Liquidity removal (liquidity provider)\n\n## Prerequisites\n\n- Node.js 18 or higher\n- npm or yarn\n- Manifold Markets API key\n- Minimum M$1000 balance for market creation\n\n## Installation\n\n### 1. Install the package\n\n```bash\nnpm install manifold-mcp-server\n```\n\n### 2. Get your API Key\n\n1. Log in to [Manifold Markets](https://manifold.markets)\n2. Go to your profile settings\n3. Generate an API key\n4. Ensure account has sufficient mana for intended operations\n\n### 3. Configure MCP Settings\n\n#### For Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"manifold\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/manifold-mcp-server/build/index.js\"],\n      \"env\": {\n        \"MANIFOLD_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### For Cline (VSCode Extension)\n\nAdd to `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"manifold\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/manifold-mcp-server/build/index.js\"],\n      \"env\": {\n        \"MANIFOLD_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Tool Documentation\n\n### Market Creation \u0026 Management\n\n#### create_market\nCreate a new prediction market:\n```typescript\n{\n  outcomeType: 'BINARY' | 'MULTIPLE_CHOICE' | 'PSEUDO_NUMERIC' | 'POLL' | 'BOUNTIED_QUESTION'\n  question: string\n  description?: string | {\n    type: 'doc'\n    content: any[]\n  }\n  closeTime?: number // Unix timestamp ms\n  visibility?: 'public' | 'unlisted'\n  initialProb?: number // Required for BINARY (1-99)\n  min?: number // Required for PSEUDO_NUMERIC\n  max?: number // Required for PSEUDO_NUMERIC\n  isLogScale?: boolean\n  initialValue?: number // Required for PSEUDO_NUMERIC\n  answers?: string[] // Required for MULTIPLE_CHOICE/POLL\n  addAnswersMode?: 'DISABLED' | 'ONLY_CREATOR' | 'ANYONE'\n  shouldAnswersSumToOne?: boolean\n  totalBounty?: number // Required for BOUNTIED_QUESTION\n}\n```\n\n#### unresolve_market\nUnresolve a previously resolved market:\n```typescript\n{\n  contractId: string\n  answerId?: string // For multiple choice markets\n}\n```\n\n#### close_market\nClose a market for trading:\n```typescript\n{\n  contractId: string\n  closeTime?: number // Optional close time\n}\n```\n\n### Market Interaction\n\n#### follow_market\nFollow or unfollow a market:\n```typescript\n{\n  contractId: string\n  follow: boolean\n}\n```\n\n#### react\nReact to markets or comments:\n```typescript\n{\n  contentId: string\n  contentType: 'comment' | 'contract'\n  remove?: boolean\n  reactionType: 'like' | 'dislike'\n}\n```\n\n### Trading Operations\n\n#### place_bet\nPlace a bet on a market:\n```typescript\n{\n  marketId: string\n  amount: number\n  outcome: 'YES' | 'NO'\n  limitProb?: number // 0.01-0.99\n}\n```\n\n#### sell_shares\nSell shares in a market:\n```typescript\n{\n  marketId: string\n  outcome?: 'YES' | 'NO'\n  shares?: number // Defaults to all\n}\n```\n\n### Liquidity Management\n\n#### add_liquidity\nAdd liquidity to market pool:\n```typescript\n{\n  marketId: string\n  amount: number\n}\n```\n\n#### remove_liquidity\nRemove liquidity from market pool:\n```typescript\n{\n  contractId: string\n  amount: number\n}\n```\n\n## Error Handling\n\nThe server implements comprehensive error handling:\n\n1. Input Validation\n   - Parameter type checking via Zod schemas\n   - Value range validation\n   - Required field verification\n\n2. API Communication\n   - Authentication errors\n   - Network failures\n   - Rate limiting\n   - Permission checks\n\n3. Business Logic\n   - Insufficient balance\n   - Invalid market states\n   - Unauthorized operations\n\n4. Error Response Format\n```typescript\n{\n  code: ErrorCode\n  message: string\n  details?: any\n}\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/bmorphism/manifold-mcp-server.git\ncd manifold-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run tests\nnpm test\n```\n\n## Contributing\n\nContributions welcome! Areas of interest:\n- Advanced market analysis tools\n- Portfolio optimization features\n- Integration with other prediction platforms\n- Documentation improvements\n\n## Security\n\n- API keys handled via environment variables\n- Input validation on all parameters\n- Rate limiting protection\n- Safe error messages\n- Role-based access control\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmorphism%2Fmanifold-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmorphism%2Fmanifold-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmorphism%2Fmanifold-mcp-server/lists"}