README.md•3.21 kB
# 🧠 ThinkingCap
A multi-agent research MCP server that runs multiple LLM providers in parallel and synthesizes their responses. Built on the Model Context Protocol for seamless integration with Claude Desktop, Cursor, and other MCP-compatible tools.
## 🌟 Features
- **🔀 Multi-Agent Research**: Deploy multiple AI agents simultaneously for comprehensive analysis
- **🎯 Multi-Provider Support**: OpenAI, Anthropic, xAI, Google, OpenRouter, Groq, Cerebras
- **⚡ Parallel Execution**: All agents run concurrently for maximum speed
- **🔄 Intelligent Synthesis**: Combines multiple perspectives into unified, comprehensive answers
- **🔍 Built-in Web Search**: DuckDuckGo search integration (no API key required)
- **🔌 MCP Native**: Works with any MCP-compatible client via `npx`
## 🚀 Quick Start
### Installation
No installation required! Just add to your MCP client configuration.
### Configuration
Add the following to your MCP client configuration (e.g., `~/.cursor/mcp.json`):
```json
{
"mcpServers": {
"thinkingcap": {
"command": "npx",
"args": [
"-y",
"thinkingcap",
"openrouter:moonshotai/kimi-k2-thinking",
"groq:moonshotai/kimi-k2-instruct-0905",
"cerebras:zai-glm-4.6",
"xai:grok-4-fast"
]
}
}
}
```
### Customizing Agents
You can specify any combination of providers and models as arguments:
```json
"args": [
"-y",
"thinkingcap",
"anthropic:claude-sonnet-4-20250514",
"openai:gpt-4o",
"google:gemini-2.0-flash"
]
```
## 📋 Supported Providers
| Provider | Env Variable | Default Model | Example |
|----------|--------------|---------------|---------|
| `openai` | `OPENAI_API_KEY` | gpt-5.1 | `openai:gpt-4o` |
| `openrouter` | `OPENROUTER_API_KEY` | moonshotai/kimi-k2-thinking | `openrouter:anthropic/claude-3.5-sonnet` |
| `groq` | `GROQ_API_KEY` | moonshotai/kimi-k2-instruct-0905 | `groq` |
| `cerebras` | `CEREBRAS_API_KEY` | zai-glm-4.6 | `cerebras` |
| `xai` | `XAI_API_KEY` | grok-4-fast | `xai:grok-4-fast` |
| `anthropic` | `ANTHROPIC_API_KEY` | claude-opus-4-5 | `anthropic` |
| `google` | `GOOGLE_API_KEY` | gemini-3-pro-preview | `google:gemini-2.0-flash` |
## 🔑 Environment Variables
API keys are read from environment variables. Add them to your `~/.bashrc` or `~/.zshrc`:
```bash
export OPENROUTER_API_KEY="sk-or-..."
export GROQ_API_KEY="gsk_..."
export CEREBRAS_API_KEY="..."
export XAI_API_KEY="..."
# etc.
```
## 🛠️ How It Works
1. **Query Decomposition**: Your research query is broken into multiple specialized questions
2. **Parallel Execution**: Each agent (provider/model combo) researches a different angle
3. **Web Search**: Each agent performs web searches to gather current information
4. **Synthesis**: All agent responses are combined into one comprehensive answer
## 🔥 OpenRouter Fireworks Routing
When using OpenRouter, requests are automatically routed to Fireworks as the preferred provider with fallbacks enabled for maximum reliability.
## 📝 License
MIT License
## 🙏 Acknowledgments
- Built on the [Model Context Protocol](https://modelcontextprotocol.io/)
- Inspired by multi-agent AI research systems