AI Consultant MCP Server
A Model Context Protocol (MCP) server that enables AI agents to consult with multiple AI models through OpenRouter. Features intelligent model auto-selection, conversation history, caching, and robust error handling.
What is this?
This MCP server allows your AI assistant (like Claude Desktop) to consult with various AI models (GPT, Gemini, Grok, etc.) through a single interface. It automatically selects the best model for your task or lets you choose a specific one.
Quick Start
Installation from npm
npm install -g ai-consultant-mcp
Prerequisites
You'll need an OpenRouter API key. Get one at OpenRouter.
Configuration
Option 1: Using npm package (Recommended)
Edit your MCP client configuration file:
For Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ai-consultant": {
"command": "npx",
"args": ["-y", "ai-consultant-mcp"],
"env": {
"OPENROUTER_API_KEY": "your-openrouter-api-key"
}
}
}
}
For other MCP clients:
Configure according to your client's documentation, using npx -y ai-consultant-mcp as the command.
Option 2: Running locally (Development)
- Clone the repository:
git clone https://github.com/filipkrayem/ai-consultant-mcp.git
cd ai-consultant-mcp
- Install dependencies:
npm install
- Build the project:
npm run build
- Configure your MCP client:
{
"mcpServers": {
"ai-consultant": {
"command": "node",
"args": ["/absolute/path/to/ai-consultant-mcp/dist/index.js"],
"env": {
"OPENROUTER_API_KEY": "your-openrouter-api-key"
}
}
}
}
Environment Variables
OPENROUTER_API_KEY(required): Your OpenRouter API keyVERBOSE_LOGGING(optional): Set totrueor1to enable detailed logging. Default:false
Available Models
- gemini-2.5-pro: Google's Gemini 2.5 Pro - general purpose tasks and quick questions
- gpt-5-codex: OpenAI's GPT-5 Codex - coding tasks, debugging, and refactoring
- grok-code-fast-1: xAI's Grok Code Fast 1 - code review, complex reasoning, and analysis
Features
- 🤖 Multiple AI models - Access GPT, Gemini, Grok, and more through one interface
- 🎯 Smart model selection - Automatically picks the best model for your task
- 💬 Conversation history - Maintain context across multiple questions
- ⚡ Response caching - Reduces API calls and costs
- 🔄 Automatic retries - Handles transient failures gracefully
- 🛡️ Circuit breaker - Prevents cascading failures
- 📊 Token tracking - Monitor usage for each consultation
Usage
Once configured, your AI assistant can use these tools:
consult_ai- Ask questions to AI models (auto-selects or specify a model)list_models- See all available models and their capabilities
Simply ask your AI assistant to consult with AI models. For example:
- "Consult this change with Grok and Codex"
- "Have Grok review your code first"
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT