Skip to main content
Glama

Mandoline MCP Server

Official
by mandoline-ai

Mandoline MCP Server

Enable AI assistants like Claude Code, Claude Desktop, and Cursor to reflect on, critique, and continuously improve their own performance using Mandoline's evaluation framework via the Model Context Protocol.


Client Setup

Most users should start here. Use Mandoline's hosted MCP server to integrate evaluation tools into your AI assistant.

For each integration below, replace sk_**** with your actual API key from mandoline.ai/account.

Claude Code

Use the CLI to add the Mandoline MCP server to Claude Code:

claude mcp add --scope user --transport http mandoline https://mandoline.ai/mcp --header "x-api-key: sk_****"

You can use --scope user (across projects) or --scope project (current project only).

Note: Restart any active Claude Code sessions after configuration changes.

Verify: Run /mcp in Claude Code to see Mandoline listed as an active server.

Official Documentation: Claude Code MCP Guide

Claude Desktop

Edit your configuration file (Settings > Developer > Edit Config):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "Mandoline": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mandoline.ai/mcp", "--header", "x-api-key: ${MANDOLINE_API_KEY}" ], "env": { "MANDOLINE_API_KEY": "sk_****" } } } }

This configuration applies globally to all conversations.

Note: Restart Claude Desktop after configuration changes.

Verify: Look for Mandoline tools when you click the "Search and tools" button.

Official Documentation: MCP Quickstart Guide

Cursor

Create or edit your MCP configuration file:

{ "mcpServers": { "Mandoline": { "url": "https://mandoline.ai/mcp", "headers": { "x-api-key": "sk_****" } } } }

You can use your global configuration (affects all projects) ~/.cursor/mcp.json or project-local configuration (current project only) .cursor/mcp.json (in project root)

Note: Restart Cursor after configuration changes.

Verify: Check the Output panel (Ctrl+Shift+U) → "MCP Logs" for successful connection, or look for Mandoline tools in the Composer Agent.

Official Documentation: Cursor MCP Guide


Server Setup

Only needed if you want to run the server locally or contribute to development. Most users should use the hosted server above.

Prerequisites: Node.js 18+ and npm

Installation

  1. Clone and build
    git clone https://github.com/mandoline-ai/mandoline-mcp-server.git cd mandoline-mcp-server npm install npm run build
  2. Configure environment (optional)
    cp .env.example .env.local # Edit .env.local to customize PORT, LOG_LEVEL, etc.
  3. Start the server
    npm start

The server runs on http://localhost:8080 by default.

Using Local Server

To use your local server instead of the hosted one, replace https://mandoline.ai/mcp with http://localhost:8080/mcp in the client configurations above.


Usage

Once integrated, you can use Mandoline evaluation tools directly in your AI assistant conversations.

Tools

Metrics

ToolPurpose
create_metricDefine custom evaluation criteria for your specific tasks
batch_create_metricsCreate multiple evaluation metrics in one operation
get_metricRetrieve details about a specific metric
get_metricsBrowse your metrics with filtering and pagination
update_metricModify existing metric definitions

Evaluations

ToolPurpose
create_evaluationScore prompt/response pairs against your metrics
batch_create_evaluationsEvaluate the same content against multiple metrics
get_evaluationRetrieve evaluation results and scores
get_evaluationsBrowse evaluation history with filtering and pagination
update_evaluationAdd metadata or context to evaluations

Resources

Access Mandoline's documentation and reference materials directly in your AI assistant, including model comparison guides and evaluation best practices.


Support


License

Apache-2.0 License - see the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to reflect on, critique, and continuously improve their performance using Mandoline's evaluation framework. Provides tools for creating custom evaluation metrics and scoring prompt/response pairs to measure AI assistant quality.

  1. Client Setup
    1. Claude Code
    2. Claude Desktop
    3. Cursor
  2. Server Setup
    1. Installation
    2. Using Local Server
  3. Usage
    1. Tools
    2. Metrics
    3. Evaluations
    4. Resources
  4. Support
    1. License

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        Facilitates interactive feature discussions with AI guidance, maintaining context and providing intelligent recommendations for implementation, architecture, and best practices in software development.
        Last updated -
        2
        1
        MIT License
        • Apple
      • A
        security
        A
        license
        A
        quality
        Provides interactive user feedback capabilities for AI assistants, helping reduce excessive tool calls by prompting users for feedback before completing tasks.
        Last updated -
        1
        1
        MIT License
        • Apple
        • Linux
      • A
        security
        A
        license
        A
        quality
        Provides tools for evaluating and benchmarking AI explanation methods through a standard interface that can be used with AI assistants and MCP-compatible applications.
        Last updated -
        11
        MIT License
      • -
        security
        F
        license
        -
        quality
        An MCP server that evaluates prompts using AI to provide detailed feedback on clarity, completeness, and effectiveness.
        Last updated -
        4

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/mandoline-ai/mandoline-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server