METAPHORE MCP Server

Turn any technical concept into a clear human story — right inside Claude Code.

Setup

1. Get your METAPHORE key

Sign up at metaphore.app → Account → copy your mkey.

2. Add to Claude Code

Run:

claude mcp add metaphore -e METAPHORE_KEY=mkey_xxxxx -- npx -y metaphore-mcp

Or manually add to your .claude/mcp.json:

{
  "mcpServers": {
    "metaphore": {
      "command": "npx",
      "args": ["-y", "metaphore-mcp"],
      "env": {
        "METAPHORE_KEY": "mkey_xxxxx"
      }
    }
  }
}

Replace mkey_xxxxx with your actual key.

3. Use it

In Claude Code, ask it to use the metaphore tool:

Use metaphore to explain what a reverse proxy is

Or with parameters:

Use metaphore to explain our microservices architecture --audience ceo --depth short

Parameters

| Parameter | Values | Description | |-----------|--------|-------------| | input | any text | Required. The technical concept to transform | | audience | ceo, junior-dev, 12-year-old, founder, operator, salesperson | Who the explanation is for | | style | building, restaurant, postal, hospital, workshop, theater | Analogy domain | | depth | short, full (default) | One paragraph vs. full 3-act story | | objective | understand, decide, debug, explain-to-someone, learn | What the reader needs to do next | | language | Any language code (fr, es, de, ...) | Override output language |

Pricing

Your METAPHORE key includes 3 free IDE transforms. Then bring your own LLM keys. After 25+ upgrade to Pro ($5/month or $29,99/year) for unlimited access at metaphore.app.

Requirements

• Node.js 18+
• A METAPHORE key (get one free)

License

CC BY-NC-SA 4.0

Created by Philippe Nerette.