Version Control · Developer Tools

Yellhorn MCP logo

Yellhorn MCP

msnidal/yellhorn-mcp

Yellhorn MCP is a Model Context Protocol server that provides full codebase context support for code assistants by integrating Gemini and OpenAI capabilities, enabling development task planning, code review and isolated environment creation.

Install

Client configuration

{
  "mcpServers": {
    "yellhorn-mcp": {
      "command": "uv",
      "args": [
        "run",
        "yellhorn-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "REPO_PATH": "<REPO_PATH>"
      }
    }
  }
}

Environment variables

GEMINI_API_KEYREPO_PATHYELLHORN_MCP_SEARCH
GitHub stars
3
Author
@msnidal
Category
Version Control, Developer Tools
License
MIT
Updated
Oct 6, 2026

About Yellhorn MCP

A Model Context Protocol (MCP) server that provides functionality to create detailed workplans to implement a task or feature. These workplans are generated with a large, powerful model (such as gemini 2.5 pro or even the o3 deep research API), insert your entire codebase into the context window by default, and can also access URL context and do web search depending on the model used. This pattern of creating workplans using a powerful reasoning model is highly useful for defining work to be done by code assistants like Claude Code or other MCP compatible coding agents, as well as providing a reference to reviewing the output of such coding models and ensure they meet the exactly specified original requirements.

Features

  • Create Workplans: Creates detailed implementation plans based on a prompt and taking into consideration your entire codebase, posting them as GitHub issues and exposing them as MCP resources for your…

  • Judge Code Diffs: Provides a tool to evaluate git diffs against the original workplan with full codebase context and provides detailed feedback, ensuring the implementation does not deviate from the…

  • Seamless GitHub Integration: Automatically creates labeled issues, posts judgement sub-issues with references to original workplan issues

  • Context Control: Use.yellhornignore files to exclude specific files and directories from the AI context, similar to.gitignore

  • MCP Resources: Exposes workplans as standard MCP resources for easy listing and retrieval

  • Google Search Grounding: Enabled by default for Gemini models, providing search capabilities with automatically formatted citations in Markdown

  • Automatic Chunking: Handles large codebases that exceed model context limits by intelligently splitting prompts

  • Rate Limit Handling: Robust retry logic with exponential backoff for rate limits and transient failures

  • Cost Tracking: Real-time cost estimation and usage tracking for all API calls

  • Multi-Model Support: Unified interface supporting OpenAI (GPT-4o, GPT-5, o3, o4-mini), xAI Grok (Grok-4, Grok-4 Fast), and Gemini (2.5-pro, 2.5-flash) models with reasoning mode support for GPT-5

Tools (5)

  • curate_context

    Analyzes the codebase and creates a.yellhorncontext file listing directories to be included in AI context.

  • create_workplan

    Creates a GitHub issue with a detailed workplan based on the title and detailed description.

  • get_workplan

    Retrieves the workplan content (GitHub issue body) associated with a workplan.

  • revise_workplan

    Updates an existing workplan based on revision instructions.

  • judge_workplan

    Triggers an asynchronous code judgement comparing two git refs (branches or commits) against a workplan described in a GitHub issue.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
core logo

core

opensumi/core

3.3k

A framework helps you quickly build AI Native IDE products.

Version Control
test1 logo

test1

trpc-group/trpc-go

942

tRPC-Go, is the Go language implementation of tRPC, which is a pluggable, high-performance RPC framework.

Version Control
AI-Gateway logo

AI-Gateway

Azure-Samples/AI-Gateway

565

New! The AI Gateway Dev Portal is now live — A starting point for building your own developer portal on top of Azure API Management AI Gateway's. Fork it, open it in VS Code with GitHub Copilot (or any coding agent), and shape it to fit your needs!

Version Control
e2b logo

e2b

e2b-dev/mcp-server

233

Deprecated: This project is no longer actively maintained. It may not receive further updates or bug fixes.

Version Control
MCP Git Ingest logo

MCP Git Ingest

adhikasp/mcp-git-ingest

180

A Model Context Protocol (MCP) server that helps read GitHub repository structure and important files.

Version Control
gitlab mcp logo

gitlab mcp

zereight/gitlab-mcp

70

Documentation → Setup guides, environment variables, and the full tool reference live on the hosted docs site.

Version Control