mentu-mcp

A meta-MCP server that collapses hundreds of tools into 12 meta-tools (~1,000 schema tokens).

How It Works

mentu-mcp sits between your MCP client and any number of child MCP servers. Instead of registering every tool from every server (which can exceed context limits), it exposes 12 meta-tools that discover, route, and execute calls across all connected servers.

Client (Claude Code, Cursor, VS Code, Windsurf...)
  |
  +-- mentu-mcp (12 meta-tools, ~1,000 tokens)
        |
        +-- mcp_discover    search across all servers
        +-- mcp_provision   intent-based provisioning
        +-- mcp_call        forward tool calls
        +-- mcp_execute     V8 sandboxed code execution
        +-- mcp_do          autonomous orchestration (API)
        +-- mcp_cortex      diagnostic advisory (API)
        +-- mcp_consult     knowledge query (API)
        +-- mcp_reload      reload configuration
        +-- mcp_elevate     trust elevation
        +-- mcp_register    runtime server registration
        +-- mcp_skill_*     skill catalog (2 tools)
        |
        +-- child-server-1 (50 tools)
        +-- child-server-2 (30 tools)
        +-- child-server-N (...)

Quick Start

# Install globally
npm install -g mentu-mcp

# Auto-configure for your MCP client
mentu-mcp --init

# Verify
mentu-mcp --version

--init detects your MCP client (Claude Code, Cursor, VS Code, Windsurf, Zed, Claude Desktop, Gemini CLI, Amazon Q) and writes the appropriate configuration file.

Supported Clients

Tools

Configuration

Add child MCP servers to ~/.mcp.json (or use --init to generate):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "my-server": {
      "command": "node",
      "args": ["./path/to/server.js"]
    }
  }
}

mentu-mcp spawns child servers lazily on first use, manages connection pooling with circuit breakers, and tears them down on idle timeout.

API Intelligence

9 of 12 tools run entirely locally with no network calls. 3 tools (mcp_do, mcp_cortex, mcp_consult) are backed by the mentu intelligence API for perception scoring, judgment evaluation, and diagnostic advisory.

Without an API key: all local tools work normally. API-backed tools return a clear error explaining the requirement.

With an API key:

export MENTU_API_KEY=your_key

Or set it in your .mcp.json:

{
  "mcpServers": {
    "mentu": {
      "command": "npx",
      "args": ["-y", "mentu-mcp"],
      "env": {
        "MENTU_API_KEY": "your_key"
      }
    }
  }
}

100 free API calls per day. No credit card required.

Intent Routing

Map natural-language intents to specific tools in your config:

{
  "intents": {
    "crawl": "crawlio.start_crawl",
    "analyze": "crawlio.analyze_page",
    "browse": "playwright.execute"
  }
}

When mcp_provision receives a request matching an intent, it routes directly to the mapped tool without searching.

Environment Variables

Contributing

See CONTRIBUTING.md for development setup, project structure, and pull request guidelines.

Security

See SECURITY.md for reporting vulnerabilities.

License

Apache-2.0