plans

Search, read, author, and triage plans on plans.devfellowship.com — the DFL planning system (plans, ADRs/decision records, and the questions/DTQ surface). This MCP wraps the same REST backend the web UI and the read-plan/search-plans/publish-plan skills use, so there is one backend and one visibility policy.

Endpoint	https://plans.mcp.devfellowship.com/mcp
Tools	11
Backing data	The plans REST API (plans.devfellowship.com/api) — plans, versions, ADRs, questions.

Connect

Add https://plans.mcp.devfellowship.com/mcp to your client (see Getting Started) with your Authorization: Bearer <token> header.

Per-user visibility — enforced, not bypassed

Every call forwards your real identity to the plans backend. The plans-app then enforces the visibility policy (locked down 2026-06-19): personal plans are owner-only, shared plans are visible to member+ (IAM level ≥ 50), and an unauthenticated call sees nothing. This MCP is a per-user consumer — it never uses a blanket service identity that would leak another user’s personal plans.

Read

Tool	Description
search_plans	Hybrid semantic + keyword search over plans (and optionally ADRs). Results are visibility-filtered to what you can read.
read_plan	Read a plan’s full markdown body + metadata by slug (optionally a specific version). Returns not-found for plans you can’t read.
list_plans	List plans with optional filters (status, source, tag, has_children, has_pending_questions). Returns only readable plans.

Write

Tool	Description
create_plan	Create a new plan (or upsert by slug). Owned by you; visibility defaults to shared. Requires a member+ identity.
publish_plan	Publish (or re-publish) a plan body, creating a new version. Upserts by slug. Requires a member+ identity.
patch_status	Transition a plan’s lifecycle status (draft → fired → executing → done / archived). Gated transitions are blocked while blocking questions are unanswered.

ADRs (Decision Records)

Tool	Description
list_adrs	List ADRs for a single plan (visibility-gated) or globally with filters (tag, decided_by).
get_adr	Get a single ADR by plan slug + decision number (or id). Visibility-gated via the parent plan.

Questions (DTQ)

Tool	Description
list_questions	List a plan’s structured questions (blocking + non-blocking), grouped by round, with options and answers.
post_question	Create a structured question on a plan (DTQ). Set blocks_execution to gate the plan’s fire/execute transitions. Requires a member+ identity.
answer_question	Record an answer to a plan question by selecting option letters, with optional freeform notes.