MCP Bench Router

Delegates design tasks to top design models via OpenRouter, using live leader rankings to route prompts.

javascript

3

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "k1ta141k-mcp-bench-router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-bench-router"
      ],
      "env": {
        "OPENROUTER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can install and run the mcp-bench-router to delegate design tasks to the top live design models on designarena.ai via OpenRouter. This MCP server routes prompts to the current leader, letting you harness cutting‑edge design capabilities without manually selecting models.

How to use

You interact with the mcp-bench-router through MCP clients. Use the provided tools to discover the top design models, browse rankings, and send prompts to either the current best model or a specific model. The server handles selecting the best available model and routing your prompt through OpenRouter.

How to install

Prerequisites you need before installing: Node.js version 18 or newer, and an OpenRouter API key for model queries that require it.

Step 1: Clone the repository and install dependencies.

git clone https://github.com/K1ta141k/mcp-bench-router.git
cd mcp-bench-router
npm install

Step 2: Build the project so the runtime artifacts are ready.

npm run build

Step 3: Run the MCP server using the standard runtime command with your OpenRouter API key. You can run it directly with a client, or via the inline command shown below.

OPENROUTER_API_KEY=YOUR_API_KEY npx -y mcp-bench-router

Optional: If you are configuring through a client build or using Claude, you can add the server as an MCP with the command shown in the setup steps of your environment.

Additional sections

Configuration notes: The server relies on an OpenRouter API key and exposes a set of tools to discover and query design models. For best results, keep your API key secure and rotate it if needed. The server fetches live rankings from designarena.ai every two hours and maps arena model names to OpenRouter identifiers.

Usage notes: You can browse the current top design models, view the full leaderboard with optional category filters, and issue prompts to either the top model or a specific model via the appropriate tool commands. The server filters out unreleased codenames and focuses on available models.

Security: Treat the OpenRouter API key like a password. Do not commit it to code repositories or share it in public channels. Use environment variable configuration in your MCP client to keep secrets out of code.

Available tools

get_best_design_model

Fetches the current #1 design model, optionally filtered by category.

get_leaderboard

Returns the full rankings with optional category filtering and pagination.

query_design_model

Sends a prompt to the best available model via OpenRouter.

query_specific_model

Sends a prompt to a specific named model via OpenRouter.