About okffs
okffs is an MCP server in the Automation category: mCP server connecting Claude Code to GitHub for an issue to branch to PR to close workflow.
Install
Claude Code
claude mcp add okffs -- npx -y @neturely/okffsnpx
npx -y @neturely/okffsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (21)
close_issueCloses an issue and tips you to `/clear` before the next one.
Parameters not published.
comment_issuePosts a comment — handy for logging what a branch did.
Parameters not published.
commit_and_updateStages, commits (message from your `hint` or the diff), pushes, and posts a progress comment to the issue.
Parameters not published.
configureWrites okffs config to `.env` — the backend for the `/okffs:setup` prompt. Reuses the `okffs setup` wizard's manifest/serializer: updates only okffs's marked block, preserving your own variables and comments. Usually driven by `/okffs:setup`, not called directly.
Parameters not published.
create_issueCreates an issue and a matching branch. Infers labels, a board `priority`/`effort`, and a native Issue Type from the task (toggle with `OKFFS_INFER_PRIORITY`/`OKFFS_INFER_EFFORT`/`OKFFS_INFER_TYPE`). Optional `assignees`, `labels`, `milestone`, `priority`, `effort`, `type`. Opens a draft PR immediately when `OKFFS_AUTO_PR=true`.
Parameters not published.
create_issues_from_listCreates many issues + branches from a task list in one shot. Confirms first. Per-task `labels`, `assignees`, `milestone`, `priority`, `effort`, `type`.
Parameters not published.
create_pull_requestOpens a PR for an issue branch — generates the title/body, pushes the branch, always includes `Closes #N`, and comments back. Can write changelog fragments when `OKFFS_UPDATE_DOCS=true`. Pass `allow_empty: true` to backfill a **draft** tracking PR on a branch with no commits (pushes an empty init commit to diverge it).
Parameters not published.
delete_branchDeletes a branch **and** closes its issue. Destructive — needs `confirmed: true`.
Parameters not published.
delete_issueCloses an issue **and** deletes its branch. Destructive — needs `confirmed: true`.
Parameters not published.
get_issueFull details for one issue: title, body, labels, assignees, branch, status.
Parameters not published.
Show all 21 tools
link_issuesLinks two issues (`blocked_by`, `blocking`, `parent`), stored under a `## Relationships` section.
Parameters not published.
list_issuesLists open issues with branch, linked PR, board column, `priority:`/`effort:`, native `type:`, and relationships as a tree — ordered by priority so the most important work is on top.
Parameters not published.
list_pr_review_commentsFetches a PR's inline review threads and summaries.
Parameters not published.
merge_pull_requestThe one okffs tool that **merges**: autonomously merges a green, review-resolved issue PR into the **base** branch (e.g. `develop`) using `OKFFS_BASE_MERGE_METHOD`, then closes the issue. Opt-in (`OKFFS_AUTO_MERGE_BASE=true`) and heavily gated — never touches `OKFFS_PROTECTED_BRANCH`, independently verifies checks/mergeability/threads. The `develop → main` promotion stays your manual merge.
Parameters not published.
planGive it a free-text description plus the breakdown Claude generates (titles, descriptions, labels, priority/effort/type, relationships); it creates every issue + branch, wires up relationships, and opens draft PRs when `OKFFS_AUTO_PR=true`. Confirms first.
Parameters not published.
prepare_releaseBumps the version, rolls the CHANGELOG, commits on a release branch, and opens a PR. Confirms first; does not tag or publish.
Parameters not published.
reply_to_review_commentReplies to an inline review thread by id.
Parameters not published.
resolve_review_threadResolves a review thread — only when `OKFFS_RESOLVE_THREADS=true`.
Parameters not published.
set_issue_fieldsSets board Priority/Effort **and/or the native Issue Type** on an **existing** issue. Priority/Effort handle project-native and org-level Issue Fields (needs `OKFFS_PROJECT_ENABLED`); `type` is org-native and works independently. `create_issue` only sets these at creation; use this afterwards. Status stays with `update_project_status`.
Parameters not published.
update_issueEdits an **existing** issue's core fields — `title`, `assignees`, `labels`, `milestone`, `body` — via one PATCH with the configured token. `labels`/`assignees` replace the whole set (`[]` clears). For Priority/Effort/Type use `set_issue_fields`; for Status use `update_project_status`.
Parameters not published.
update_project_statusMoves an issue between board columns (`Backlog`, `Ready`, `In Progress`, `Review`). Needs `OKFFS_PROJECT_ENABLED`.
Parameters not published.
Ask AI
✦
Ask AI about okffs
Powered by Claude · Grounded in docs
I know everything about okffs. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.