{"id":28918359,"url":"https://github.com/carlosibcu/polymarket-mcp","last_synced_at":"2026-05-07T03:35:37.923Z","repository":{"id":299400949,"uuid":"1002904777","full_name":"CarlosIbCu/polymarket-mcp","owner":"CarlosIbCu","description":"Model Context Protocol server for Polymarket CLOB – FastAPI, Docker-ready, LLM-tool compatible","archived":false,"fork":false,"pushed_at":"2025-07-02T12:06:45.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T12:28:57.114Z","etag":null,"topics":["ai","api","clob","continue-vscode","crypto","cursor","defi","docker","fastapi","github-copilot-chat","jetbrains-ai-assistant","llm-tools","mcp","model-context-protocol","openai-assistants-api","plugin","polymarket","prediction-markets","python","server"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CarlosIbCu.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,"zenodo":null}},"created_at":"2025-06-16T10:21:03.000Z","updated_at":"2025-07-02T12:06:49.000Z","dependencies_parsed_at":"2025-06-16T11:40:28.267Z","dependency_job_id":"c0e2b64f-4f63-4865-8656-91815c318502","html_url":"https://github.com/CarlosIbCu/polymarket-mcp","commit_stats":null,"previous_names":["carlosibcu/polymarket-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CarlosIbCu/polymarket-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosIbCu%2Fpolymarket-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosIbCu%2Fpolymarket-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosIbCu%2Fpolymarket-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosIbCu%2Fpolymarket-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarlosIbCu","download_url":"https://codeload.github.com/CarlosIbCu/polymarket-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosIbCu%2Fpolymarket-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263290887,"owners_count":23443674,"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":["ai","api","clob","continue-vscode","crypto","cursor","defi","docker","fastapi","github-copilot-chat","jetbrains-ai-assistant","llm-tools","mcp","model-context-protocol","openai-assistants-api","plugin","polymarket","prediction-markets","python","server"],"created_at":"2025-06-22T02:02:47.334Z","updated_at":"2026-05-07T03:35:37.868Z","avatar_url":"https://github.com/CarlosIbCu.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polymarket MCP Server\n\nA **Model Context Protocol (MCP)** compliant server that exposes the public Polymarket Central Limit Order Book (CLOB) REST API as tools that any LLM-powered IDE or agent can invoke. Compatible with **Cursor**, **Continue** (VS Code), **GitHub Copilot Chat**, **JetBrains AI Assistant**, **OpenAI ChatGPT (Assistants API)**, **Smithery** and any other MCP-aware interface.\n\n---\n\n## ✨ Features\n\n* 🪄 **Universal MCP Support** – works with Cursor, Continue, Copilot, JetBrains AI, Smithery and more\n* ⚡ **Python implementation** – using native MCP protocol with async support\n* 📈 **Essential endpoints out-of-the-box** – list markets, fetch single market details and more\n* 🔌 **Stateless \u0026 no auth required** – queries Polymarket's public REST endpoints; no keys needed\n* 🐳 **Docker-ready** – ship \u0026 deploy anywhere in seconds\n* 📝 **MIT licensed** – free for personal and commercial use\n\n---\n\n## 🚀 Quick Start\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/CarlosIbCu/polymarket-mcp.git\ncd polymarket-mcp\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run the server\npython -m polymarket_mcp.main\n```\n\n### Testing with MCP Inspector\n\nYou can test the server using the official MCP Inspector:\n\n```bash\n# Install and run the MCP Inspector\nnpx @modelcontextprotocol/inspector python -m polymarket_mcp.main\n```\n\nThis will:\n1. Start the MCP server\n2. Launch the inspector web interface\n3. Provide a URL to access the inspector (usually http://localhost:6274)\n\nThe inspector allows you to:\n- View available MCP tools\n- Test tool calls interactively\n- Inspect server capabilities\n- Debug MCP protocol messages\n\n### Docker Deployment\n\n```bash\n# Build the image\ndocker build -t polymarket-mcp .\n\n# Run the container\ndocker run -p 3333:3333 polymarket-mcp\n```\n\n### Smithery Deployment\n\nThis server is ready for deployment on [Smithery](https://smithery.ai), the MCP hosting platform:\n\n1. Fork/clone this repository\n2. Connect your GitHub account to Smithery\n3. Select this repository and choose \"Custom Deploy\"\n4. Smithery will automatically detect the configuration and deploy\n\nThe `smithery.yaml` configuration includes:\n- Container runtime settings\n- Server configuration options\n- Health checks\n- Tool schemas\n\n## 🛠 Available Tools\n\n### `list_markets`\nList available prediction markets with optional limit parameter.\n\n**Parameters:**\n- `limit` (integer, optional): Maximum number of markets to return (default: 10)\n\n**Example:**\n```json\n{\n  \"limit\": 5\n}\n```\n\n### `get_market`\nFetch detailed information about a specific market.\n\n**Parameters:**\n- `market_id` (string, required): Market ID to fetch\n\n**Example:**\n```json\n{\n  \"market_id\": \"0x9deb0baac40648821f96f01339229a422e2f5c877de55dc4dbf981f95a1e709c\"\n}\n```\n\n## 🔧 Configuration\n\nServer configuration is handled via environment variables or Smithery config:\n\n```yaml\nserver:\n  host: \"0.0.0.0\"  # Server host\n  port: 3333       # Server port\n  timeout: 30      # Request timeout in seconds\n```\n\n## 📚 API Documentation\n\n- **MCP Inspector**: Use `npx @modelcontextprotocol/inspector` for interactive testing\n- **Polymarket API Docs**: [Official Documentation](https://docs.polymarket.com)\n\n## 🧪 Testing\n\n```bash\n# Test the Polymarket API connectivity\npython test_server.py\n\n# Run with MCP Inspector for interactive testing\nnpx @modelcontextprotocol/inspector python -m polymarket_mcp.main\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is MIT licensed. See the [LICENSE](LICENSE) file for details.\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosibcu%2Fpolymarket-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlosibcu%2Fpolymarket-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosibcu%2Fpolymarket-mcp/lists"}