polydev-ai
v1.10.25
Published
Multi-model AI perspectives for coding agents - query GPT-5, Claude, Gemini, and Grok simultaneously through one MCP server
Maintainers
Readme
Polydev
🚀 One-Command Install
Claude Code
claude mcp add polydev -- npx -y polydev-ai@latestCursor / Windsurf / Cline
npx polydev-ai@latestOpenAI Codex CLI
npx polydev-ai@latestGet your token at polydev.ai/dashboard/mcp-tokens
Why Polydev?
Stop copy-pasting between ChatGPT, Claude, and Gemini. Get all their perspectives in your IDE with one request.
| Metric | Result | |--------|--------| | SWE-bench Verified | 74.6% Resolve@2 | | Cost vs Claude Opus | 62% lower | | Response time | 10-40 seconds |
"Different models have different blind spots. Combining their perspectives eliminates yours."
How It Works
Your Agent → Polydev MCP → [GPT-5, Claude, Gemini, Grok] → Synthesized AnswerWhen your AI agent gets stuck, Polydev consults multiple frontier models simultaneously and returns their combined perspectives. One request, four expert opinions.
Quick Start
Option 1: Use Hosted Service (Recommended)
Get started instantly at polydev.ai
Step 1: Install the MCP server
npx polydev-ai@latestStep 2: Set your token (get it from polydev.ai/dashboard/mcp-tokens)
export POLYDEV_USER_TOKEN="pd_your_token_here"Option 2: Self-Host with Your Own API Keys
Step 1: Clone and install
git clone https://github.com/polydev-ai/polydev.gitcd polydev && npm installStep 2: Configure environment
cp .env.example .env.localStep 3: Add your API keys to .env.local and run
npm run devIDE Configuration
Claude Code
One command:
claude mcp add polydev -- npx -y polydev-ai@latestOr add to ~/.claude.json:
{
"mcpServers": {
"polydev": {
"command": "npx",
"args": ["-y", "polydev-ai@latest"],
"env": {
"POLYDEV_USER_TOKEN": "pd_your_token_here"
}
}
}
}Cursor / Windsurf / Cline
Add to your MCP config (usually ~/.cursor/mcp.json or similar):
{
"mcpServers": {
"polydev": {
"command": "npx",
"args": ["-y", "polydev-ai@latest"],
"env": {
"POLYDEV_USER_TOKEN": "pd_your_token_here"
}
}
}
}OpenAI Codex CLI
Add to ~/.codex/config.toml:
[mcp_servers.polydev]
command = "npx"
args = ["-y", "polydev-ai@latest"]
[mcp_servers.polydev.env]
POLYDEV_USER_TOKEN = "pd_your_token_here"
[mcp_servers.polydev.timeouts]
tool_timeout = 180
session_timeout = 600Usage
Once connected, your agent can call:
{
"tool": "get_perspectives",
"arguments": {
"prompt": "How should I refactor this authentication flow?"
}
}Or just mention "polydev" or "perspectives" in your prompt:
"Use polydev to debug this infinite loop"
"Get perspectives on: Should I use Redis or PostgreSQL for caching?"Use Your Existing CLI Subscriptions
Already paying for ChatGPT Plus, Claude Pro, or Gemini Advanced? Use those subscriptions directly through your CLI tools.
| Subscription | CLI Tool | Setup |
|--------------|----------|-------|
| Claude Pro ($20/mo) | Claude Code | claude login |
| ChatGPT Plus ($20/mo) | Codex CLI | codex login |
| Gemini Advanced ($20/mo) | Gemini CLI | gemini login |
Polydev can route requests through your authenticated CLI sessions — your subscription quota is used, no extra API costs.
Self-Hosting
Requirements
- Node.js 18+
- PostgreSQL (or Supabase)
- API keys for the models you want to use
Environment Variables
Create a .env.local file:
# Database
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
# AI Providers (add the ones you want)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
XAI_API_KEY=...Database Setup
cd supabase && supabase db pushRun
npm run devResearch
Our approach achieves 74.6% on SWE-bench Verified (Resolve@2), matching Claude Opus at 62% lower cost.
| Approach | Resolution Rate | Cost/Instance | |----------|-----------------|---------------| | Claude Haiku (baseline) | 64.6% | $0.18 | | + Polydev consultation | 66.6% | $0.24 | | Resolve@2 (best of both) | 74.6% | $0.37 | | Claude Opus (reference) | 74.4% | $0.97 |
Project Structure
polydev/
├── src/ # Next.js application
│ ├── app/ # App router pages & API routes
│ ├── components/ # React components
│ ├── hooks/ # Custom React hooks
│ └── lib/ # Utilities and services
├── mcp/ # MCP server implementation
├── supabase/ # Database migrations
├── docs/ # Documentation
└── public/ # Static assetsContributing
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
# Fork the repository, then:
git clone https://github.com/YOUR_USERNAME/polydev.gitcd polydev && npm installgit checkout -b feature/amazing-featuregit commit -m 'Add amazing feature'git push origin feature/amazing-featureThen open a Pull Request.
Links
- Website: polydev.ai
- Documentation: polydev.ai/docs
- npm: npmjs.com/package/polydev-ai
- Research: SWE-bench Paper
License
MIT License - see LICENSE for details.
