Meta-Prompt MCP

A Prompting Oracle — An MCP server that bridges official Prompting Guides with your LLM workflow to help you generate highly accurate, effective, and structured meta-prompts.

What It Does

Meta-Prompt MCP is a specialized Model Context Protocol (MCP) server that acts as an automated "Prompting Oracle." It empowers any MCP-compatible host (Claude Desktop, Cursor, etc.) to query expert Prompting Guides mid-conversation.

When building AI workflows, creating robust "meta-prompts" (system prompts for agents) is critical. Instead of guessing how to instruct an LLM, this server provides immediate access to authoritative guidelines. By surfacing these best practices on-demand, it ensures the meta-prompts you generate are exceptionally accurate, helpful, and grounded in proven methodology.

Architecture

┌─────────────────────┐     stdio      ┌──────────────────────────┐
│   MCP Host          │◄──────────────►│   Meta-Prompt MCP        │
│   (Claude Desktop,  │                │                          │
│    Cursor, IDEs)    │                │   ┌──────────────────┐   │
│                     │                │   │  FastMCP Server   │   │
│                     │                │   │  • get_google_    │   │
│                     │                │   │    guide          │   │
│                     │                │   │  • get_anthropic_ │   │
│                     │                │   │    guide          │   │
│                     │                │   └────────┬─────────┘   │
│                     │                │            │              │
│                     │                │   ┌────────▼─────────┐   │
│                     │                │   │  ./data/         │   │
│                     │                │   │  (markdown files) │   │
│                     │                │   └──────────────────┘   │
└─────────────────────┘                └──────────────────────────┘

Key Features

| Feature | Details | |---------|---------| | get_google_guide tool | Retrieves the comprehensive Google Prompting Guide to inform clear, context-rich prompting strategies | | get_anthropic_guide tool | Retrieves the full Anthropic Prompting Guide for mastering capabilities and system prompts | | Offline capable | Runs entirely locally, reading from bundled markdown files with zero API dependencies |

Benchmark Results

To validate the tool's impact, we ran a benchmark comparing prompts generated with and without the prompting guides across 5 diverse tasks. An independent judge LLM scored each prompt on Clarity, Specificity, Structure, Effectiveness, and Overall quality (1–10 scale).

View Full Benchmark Results →

Run the benchmark yourself:

export OPENROUTER_API_KEY=sk-or-...
make benchmark

Quick Start

1. Install

# Via uvx (recommended — run without installing globally)
uvx meta-prompt-mcp

# Or install via pip
pip install meta-prompt-mcp

The package ships with bundled markdown guides — no API keys or setup needed.

2. Configure Your MCP Host

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "meta-prompt-mcp": {
      "command": "uvx",
      "args": ["meta-prompt-mcp"]
    }
  }
}

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "meta-prompt-mcp": {
      "command": "uvx",
      "args": ["meta-prompt-mcp"]
    }
  }
}

Claude Code

Run the following command in your terminal:

claude mcp add meta-prompt-mcp -- uvx meta-prompt-mcp

Development

# Clone the repo
git clone <your-repo-url>
cd meta-prompt-mcp

# Install in dev mode
make d

... [View full README on GitHub](https://github.com/kapillamba4/meta-prompt-mcp#readme)