
Hosted MCP docs for Keelen, an AI coding agent for GitHub. Build apps and internal tools or progress
Hosted MCP docs for Keelen, an AI coding agent for GitHub. Build apps and internal tools or progress a defined backlog with approval and merge controls you choose.
·
Steer Keelen, the AI coding agent for GitHub, from your chat.
Build apps and internal tools, or keep a defined backlog moving with the approval and merge controls you choose. Keelen turns requests into a standing roadmap, plans tasks, runs checks and opens pull requests in your repository.
Paste SETUP.md into a compatible MCP client and say "set me up." Your agent guides account setup and project creation. You confirm your email and complete AI credential connection, GitHub approval and any billing steps in the browser. Once connected, use chat to submit requests, set priorities and answer questions about the work.
Use your own supported AI subscription or API key with Claude Code, Codex, GLM, Kimi or Grok. Keelen adds no markup to AI usage. See how the MCP workflow works.
This repo is documentation only. It describes the hosted Model Context
Protocol (MCP) server at
https://keelen.ai/mcp. Keelen runs the coding workflow as a hosted service;
this repository contains its documentation and client configuration examples.
The recording shows an earlier setup flow. Follow the current instructions below for account verification and browser approvals.
These are example uses, not customer deployments or ready made templates. You set priorities and choose plan approval, manual merge or other supported controls for each project. Keelen checks changes before they can merge and holds failed checks. Capacity, provider limits, missing information and decisions can pause progress; a queue is not a promise of finished work by a particular time.
Connect credentials in the Keelen dashboard, never in the MCP chat. The workspace API key used by your MCP client is separate from these credentials.
| AI engine | Supported connection |
|---|---|
| Claude Code | Claude Pro or Max sign in, or an Anthropic API key |
| Codex | ChatGPT sign in, or an OpenAI API key |
| GLM | Z.ai API key |
| Kimi | Kimi Code membership key or Moonshot Open Platform API key |
| Grok | SuperGrok sign in or xAI API key |
Engine availability can differ by role. Grok here means the coding engine; it does not establish Grok Bot compatibility as an MCP client. OpenRouter is currently limited to Keelen's own test and benchmark projects and is not enabled for customer repositories.
For a headless / API-key client (including Claude Code with a bearer key), connect the full surface without a token first, then hand your agent the setup instructions:
claude mcp add --transport http keelen https://keelen.ai/mcpThen paste the contents of SETUP.md into your agent and say
"set me up". It will ask for your email and the verification code that
lands in your inbox. It then guides you through connecting an AI engine,
approving GitHub access, creating or importing a project, and provisioning.
Follow the dashboard links for the steps that require your browser.
The whole flow on one page, with the 50-second demo: https://keelen.ai/mcp-server/?utm_source=mcp-server&utm_medium=github-readme&utm_campaign=setup
Using a different client? See the per-client guides:
Claude connects through OAuth — there is no API key to paste. Add the connector by URL and sign in through the browser consent page as the workspace owner:
https://keelen.ai/claude/mcpclaude mcp add --transport http keelen https://keelen.ai/claude/mcpThe OAuth grant requests read and write access by default; actions that need administrator authority ask for a step-up re-consent. Claude Code completes OAuth through a localhost callback on a randomly assigned port.
https://keelen.ai/claude/mcp is the Claude directory surface. It omits two
tools, so it always exposes 40 tools: get_billing (billing is handled in
the Keelen dashboard) and project_digest. The full surface, including both
of those tools, is https://keelen.ai/mcp — use it for the headless /
API-key path described above.
This repository is also the Claude Code plugin bundle. Two manifest pairs ship here and point at different surfaces:
| Files | Ecosystem | MCP surface |
|---|---|---|
.claude-plugin/plugin.json + .mcp.json | Claude Code plugin | https://keelen.ai/claude/mcp |
plugin.json + mcp.json | agent-plugins.org | https://keelen.ai/mcp |
The Claude Code plugin is installable from Anthropic's plugin directory once it is listed there; until then the per-client setup above is the supported path. Guides: Claude Code, Claude Desktop.
Building a Roblox game? Keelen can generate art, audio, meshes, skyboxes, and
animated characters from plain-language requests — see
roblox-assets.md.
The server exposes 41 tools by default, or 42 tools when the default-OFF
project_digest flag is enabled. project_digest is off by default and is
not generally available. Two work with no key at all (signup, verify_email);
the rest need the bearer key verify_email gives you. Full reference with
parameters and behavior: TOOLS.md.
| Group | Tools |
|---|---|
| Getting started | signup, verify_email |
| Onboarding | get_onboarding_status, open_dashboard, connect_github, list_github_repos, import_project, get_provisioning_status, get_billing |
| Projects & roadmap | project_digest, list_projects, create_project, archive_project, delete_project, submit_request, get_request_status, answer_request, refine_request, set_product_vision, set_product_goal, get_product_vision, get_product_goal, list_roadmap, reorder_roadmap, cancel_roadmap_item, clear_horizon_pin, project_status, list_escalations, resolve_escalation, retry_blocked_task, rearm_roadmap_item, resolve_platform_policy_conflict, replan_task, close_task, control_scheduler, set_ui_review_scenario_cap, rollback_roblox_place |
| Reviews | run_security_review, run_legal_exposure_review, get_legal_exposure_findings, run_control_gap_review, get_control_gap_findings |
The server speaks MCP protocol revision 2026-07-28 as well as the earlier
handshake revisions, from the same endpoint — no client action is required
either way. Details in clients/generic.md;
notable contract changes are recorded in CHANGELOG.md.
Portfolio Manager 0.4.1 is the manual template for managing selected existing public or private projects. Open the published 0.4.1 template and follow the guide to connect your own account. The separate Portfolio OAuth surface is available. The portfolio reference documents its scoped interface and optional 0.4 management features. Delegated actions require additional owner opt-in and are not enabled by copying the manual template; manual management reads use the selected-project consent. The primary MCP setup above is unchanged.
Is my code touched before I agree to anything? No. Connecting the MCP
server tokenless only lets you sign up and verify your email — it can't see,
read, or modify any repository. connect_github requires an explicit
GitHub App install you approve in your browser, and every following build
runs inside an isolated per-tenant sandbox scoped to your own workspace.
What does it cost? Signing up, connecting GitHub, and creating a project
are all free. Actually running the autonomous loop (compute) requires an
active subscription — get_billing() returns a Stripe checkout link the
moment you're ready. A free/unpaid workspace can do everything up through
project creation. Work can start once billing is active,
the project's loop is enabled and its setup requirements are satisfied.
How do I revoke access? Every key minted through this flow (or the dashboard) can be individually revoked. Go to your Keelen dashboard → Settings → API keys and delete the key. Revoking takes effect immediately; your agent will need a fresh key (rerun the signup flow, or mint a new one from the dashboard) to keep calling the server.
See SECURITY.md for the full security model: what the MCP
server can and can't reach, rate limits, and key handling.
Questions or issues: [email protected]
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/keelen-mcp to learn what the "Keelen Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http keelen https://keelen.ai/mcp| Name | What it does |
|---|---|
list_projects | List the projects in this workspace, with what each one is building. |
create_project | Start building something new: creates a GitHub repo and begins work on it. For a NEW repo. Given an existing repo, import_project(repo_full_name) is the right call — this one would create a s |
submit_request | Ask for a change in plain English: a feature, a bug fix, or a new direction. Each call carries ONE feature or intent; a multi-feature ask belongs in separate requests. `text` must be under 16 |
get_request_status | Check what happened to a request, and read any questions it asked back. Intake is async (~5min cadence), so the status changes between calls. `next_action` is one of: "wait" (still processing |
set_product_vision | Say what this product is for, so every run knows what it is building toward. `vision_md` is free-form markdown and must be non-empty. Tenant-scoped: a project not in the caller's workspace 40 |
set_product_goal | Set the outcome to aim at right now, so work is prioritised toward one thing. `goal_md` is free-form markdown and must be non-empty. Tenant-scoped: a project not in the caller's workspace 404 |
list_roadmap | See what is planned for a project and in what order. Queued rows also say whether the expand picker would elect them (`electable`) and, when not, why it skips them (`skip_reason`: awaitin |
reorder_roadmap | Change what gets built first. `ordered_ids` is the desired front-to-back order of queued roadmap-item ids (list_roadmap returns them). The first id becomes the highest priority — the cade |
cancel_roadmap_item | Cancel / close a single roadmap item (list_roadmap returns its id). For a DELIVERED or duplicate item that keeps re-parking: once the work has shipped, every expand produces no dev-ready task |
clear_horizon_pin | Clear a queued roadmap item's horizon pin (now/next/later → none). A horizon pin dominates the queue sort, so `reorder_roadmap` cannot move a pinned item out of its band — a stale `now` pin o |
rollback_roblox_place | Roll a Roblox project's place back to a previously-published version. For a `roblox_game` project, re-publishes the RETAINED build artifact for `version_number` (the web Roblox Publishing car |
project_status | Check how a project is doing: what is in flight, what shipped, what is stuck. Returns lifecycle status, open task count, queued roadmap item count, runs today, verification pass rate, open bl |
close_task | Close a task that should not be built — a duplicate, or work already shipped. For a task on the board that is obsolete: the change already landed in another PR, a sibling task covers it, or t |
get_product_goal | Read a project's current product goal (the outcome work is aimed at). The paired setter `set_product_goal` replaces the whole document rather than appending to it, so a write without a prior |
get_product_vision | Read a project's current product vision (what the product is for). The paired setter `set_product_vision` replaces the whole document rather than appending to it, so a write without a prior r |
list_escalations | See what the work is stuck on and waiting for a human decision about. `project_status` only COUNTS open escalations; this returns each one with its kind, reason, detail_md, recommended_action |
resolve_escalation | Acknowledge a handled ask only when no blocked task becomes invisible. `decision_md` is a required short note (why/how it was resolved), appended to the escalation's detail_md as an audit tra |
answer_planning_question | Answer an open planning question and release its roadmap item. Use this for a `list_escalations` row with reason `expand_needs_clarification` (its `next_tool` names this tool). The planne |
retry_blocked_task | Grant one fresh attempt after fixing a recovery-budget task block. ``escalation_id`` is the task_block id returned by ``list_escalations``. Eligibility, tenant, task, failure class, task stat |
requeue_for_review | Return one blocked task's existing pull request to normal review. Requires a personal OAuth connection of an active workspace owner; workspace keys are refused. Pass the task id (not an escal |
rearm_roadmap_item | Run the dashboard's replay-guarded same-item dependency re-arm. ``escalation_id`` is an ``expand_produced_nothing`` or ``roadmap_item_parked`` escalation id. Keelen verifies delivered structu |
resolve_platform_regression | Recover a task Keelen's own postprocessor re-broke. ``escalation_id`` is an open ``platform_policy_conflict`` card that the server attributed to Keelen's postprocessor writer. ``decision_md`` |
list_steering_rules | List this project's active and pending steering rules. Steering rules are prepended to every planning, development and QA prompt. Each rule has `state` (`active` = in the prompt, `pending` = |
approve_steering_rule | Approve one pending steering rule so it reaches the iteration prompts. Pass the project id and the rule `id` from list_steering_rules. Only a `pending` rule changes; an already active rule re |
retire_steering_rule | Retire one steering rule so no later iteration prompt carries it. Pass the project id and the rule `id` from list_steering_rules. Works for an active or a pending rule, including a retro kaiz |
retire_steering_rules | Retire several steering rules in one transaction. Pass the project id and 1-100 rule `id` values from list_steering_rules. Works for active and pending rules, including a retro kaizen the aut |
replan_task | Replace an unretryable blocked task without losing its lineage. Creates a fresh, explicitly planned task under the same roadmap item and attempt lineage, transfers prerequisites and downstrea |
remove_cancelled_dependency | List or remove a dependency on a task cancelled without delivery. ``escalation_id`` is a ``prerequisite_hold_stalled`` card. A waiting task whose dependency points at a task cancelled without |
control_scheduler | Start, pause, or resume a project's autonomous work. `action` is one of: "enable" | "disable" | "resume" | "process_now". - enable/disable flip scheduler_enabled (the loop dispatches only ena |
archive_project | Archive a project (reversible shelve) — frees a project slot in-tool. Stops any in-flight machine, then flips the project to `archived`: it drops out of the per-tier project cap (freeing a sl |
delete_project | Soft-delete a project (the harder option) — frees a slot and hides it. Stops any in-flight machine, then flips the project to `deleted`: it disappears from `list_projects`, drops out of the p |
run_security_review | Find security problems in a repository: a deep, whole-codebase review. Spawns a one-shot audit that scans the repo across a kind-aware taxonomy (secrets + git history, vulnerable/abandoned de |
run_legal_exposure_review | Find where a codebase creates legal exposure (privacy, consent, data handling). Spawns a one-shot review machine that reads the checkout offline and maps what the code DOES onto commonly cite |
get_legal_exposure_findings | Read a project's legal exposure findings, worst exposure first. Returns each finding as an OBSERVATION plus the obligation commonly cited over that pattern, its citation, the date the citatio |
run_control_gap_review | Start a source-bound security control gap review for one project. The review records bounded engineering observations under the user's selected Cyber Essentials or CMMC Level 1 or Level 2 con |
get_control_gap_findings | Read a project's security-control observations and review boundaries. The result groups records by evidence class without a total or an overall framework outcome. `not_determinable` and `outs |
answer_request | Answer a thread's clarifying questions (status must be awaiting_answers). `answers` is a list of {"idx": <int from get_request_status>, "answer_md": <str, 1..2000 chars>}. Every question need |
refine_request | Say what is wrong with what a request produced, and have it reworked. Status must be "done". `feedback_md` is 1..1979 chars. Moves the thread to refine_pending; get_request_status reports the |
signup | Create a Keelen account (or start agent login) — emails a 6-digit code. UNAUTHENTICATED — the only tool besides verify_email that works before a bearer key is configured. `email` is where the |
verify_email | Redeem the emailed 6-digit code for a reveal-once workspace API key. UNAUTHENTICATED. `email` + `code` must match a code issued by signup(email) within the last 15 minutes (5 attempts max). T |
get_onboarding_status | Check what is set up so far and what to do next to get building. Reports engine_connected / github_connected / project_count / payment_status and a `next_action` string whose value is authori |
open_dashboard | Get a one-click, pre-authenticated dashboard sign-in link for the owner. The engine-connect step — and any dashboard task (billing card update, a project page) — needs a signed-in browser. Be |
connect_github | Get the link that connects a GitHub account, so work can reach real repos. Returns an `install_url` that the user opens in a browser to pick the GitHub account/org, approve the install, and l |
list_github_repos | List the CALLER's own GitHub-visible repos (for import_project). For an OAuth connector that is the connected member; for a static workspace key it is an eligible active owner. Each entry has |
import_project | Connect an EXISTING GitHub repo as a Keelen project. This is the counterpart of create_project: it is for a repo that already exists, while create_project scaffolds a brand-new one. `rep |
get_provisioning_status | Check whether a new project has finished setting up and is ready to build. Returns overall (provisioning | ready | errored), a 7-stage checklist, and a user-facing error_kind when a stage fai |
get_billing | Billing status + a Stripe checkout link when a NEW subscription is needed. `plan` is one of starter | pro | agency (default starter). When the workspace has NO live subscription and needs one |
project_digest | Read a compact progress digest for one project (delivery, activity, holds, next decision). Returns the closed MCP projection: delivery counts and the five newest delivered items, a recent |
stop_iteration | Stop one running iteration after confirmed runtime cleanup. Requires a personal active workspace owner. Workspace keys and Portfolio delegation cannot stop compute. The exact project iteratio |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/keelen-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "keelen-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.