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 key
VERBOSE_LOGGING (optional): Set to true or 1 to 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

AI Consultant MCP Server