Kitbash MCP

An MCP server that checks against the GitHub API which parts of your idea already exist as repositories and drops invented ones.

  • 56 ★ on the repository
  • Last commit
  • GPL-2.0
MCP server

Extended access

Why this level

  • The server calls the GitHub API with your token and sends repository names derived from your idea there.
  • The package is built from GitHub on the first `npx` launch.
All reasons and checks

open-dev-society/kitbash

Install

Manual install

/plugin marketplace add Open-Dev-Society/kitbash

Then `/plugin install kitbash@kitbash`. Without the plugin the `claude mcp add kitbash` command works.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The server calls the GitHub API with your token and sends repository names derived from your idea there.
  • The package is built from GitHub on the first `npx` launch.

This is third-party code. Review the repository files before installing.

What it does

Kitbash helps an agent avoid writing from scratch what is long solved. You describe what you plan, for example an app that watches a folder and makes scanned PDFs searchable. The agent splits the idea into three to six components and picks a verdict for each: borrow, adapt or write yourself. It then names candidate repositories. There is no model inside the server. The `kitbash` tool hands the agent only a rubric, and `kitbash_verify` checks the slate against the GitHub API: nonexistent repositories are dropped, while archived, unlicensed, forked and abandoned ones get flags. The final report holds only repositories confirmed seconds before it is shown. A network failure or rate limit is reported as could not check.

Who it is for. Developers who ask an agent to build an app and first want to see what already exists in open repositories.

Good fit when

  • Before a project starts you need to see which components are easier to take ready-made.
  • An agent names repositories and you need to confirm they exist and are not abandoned.
  • A hard area such as PDF, OAuth or timezones is better served by a mature library.
  • The choice depends on stack and licence and you need recommendations under those limits.

Not a fit when

  • You need private repositories: without a token that has access they look nonexistent.
  • The task is small and searching takes longer than writing.
  • The search is outside GitHub, for example through package registries.

Example request

Use kitbash: a desktop app that watches a folder and makes scanned PDFs searchable. TypeScript, MIT.

MCP

Transport
stdio, http
Authentication
not required

Environment variables

GITHUB_TOKEN secret
A scopeless GitHub token that lifts the 60 requests an hour limit.

Limitations

Without a token GitHub allows 60 requests an hour, so for real workloads set `GITHUB_TOKEN` or `GH_TOKEN` or sign in with `gh`; the token needs no scopes. Private repositories without access appear as not found. The first `npx` launch installs and builds the package in about 25 seconds. Candidate quality depends on what your model knows: the server verifies names but invents none. The project licence is GPL-2.0, which requires open source when distributing changes.

How to disable. Remove the server with `claude mcp remove kitbash` or the `kitbash` entry from the client MCP configuration. If you installed the plugin, remove it through the plugin manager.

FAQ

How do I connect Kitbash to Claude Code?

Through the plugin: `/plugin marketplace add Open-Dev-Society/kitbash`, then `/plugin install kitbash@kitbash`. Or as an MCP server: `claude mcp add kitbash -- npx -y github:Open-Dev-Society/kitbash`.

How do I connect it to Codex or Cursor?

For Codex: `codex mcp add kitbash -- npx -y github:Open-Dev-Society/kitbash`. For Cursor, Claude Desktop and Windsurf add an `npx` command with the `-y` and `github:Open-Dev-Society/kitbash` arguments to the MCP configuration.

Is an API key needed?

No, neither a key nor sign-up is needed. A GitHub token is optional but recommended because of the 60 requests an hour limit without one.

What do the two tools do?

`kitbash` hands over the idea decomposition rubric, and `kitbash_verify` checks repository names against the GitHub API, ranks survivors and builds the report.

Can I use it without MCP?

Yes, `npx skills add Open-Dev-Society/kitbash` installs a skill with the same rubric that reaches the same checker with no MCP connection.

Discussion

No questions or reviews yet.

Official

An MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens

MCP serverExtended access961Repository stars

A teaching MCP server in Python: Hacker News search, GitHub repository details and examples of model sampling requests

MCP serverExtended access327Repository stars

A CLI compiler that reads app code, API specs and database schemas and generates a ready MCP server with tool permission checks.

CLIExtended access107Repository stars
Official

A local codebase index with ten MCP tools: dependency graph, git history, code health and architectural decisions without re-grepping on every step

MCP serverExtended access8.1KRepository stars

A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them

PluginExtended access10.9KRepository stars

An MCP server that turns GitHub Projects v2 into a work queue for agents: they claim tasks, report progress and spend a budget.

MCP serverBroad access105Repository stars

README in short

The README explains the idea of verifying repositories an agent recalls and shows the exchange diagram with GitHub. Connection options for different clients, token handling, self-hosting and the project layout follow.

README badge

Report a problem