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
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.
Install
- Works in
Manual install
/plugin marketplace add Open-Dev-Society/kitbashThen `/plugin install kitbash@kitbash`. Without the plugin the `claude mcp add kitbash` command works.
Access and checks
How we reviewExtended 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_TOKENsecret- 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.
Related
MCP serversAn MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens
A teaching MCP server in Python: Hacker News search, GitHub repository details and examples of model sampling requests
A CLI compiler that reads app code, API specs and database schemas and generates a ready MCP server with tool permission checks.
A local codebase index with ten MCP tools: dependency graph, git history, code health and architectural decisions without re-grepping on every step
A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them
An MCP server that turns GitHub Projects v2 into a work queue for agents: they claim tasks, report progress and spend a budget.
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.