mdflow — Context OS for AI Coding Agents
OCI · GHCR.IO/YUBINBIN32-OPS/MDFLOW:0.3.7
Context OS for AI coding agents: task-scoped AST context, verified mutation, and rollback.
Available components
Last scanned (39 minutes ago)
Scores higher than 48% of OCI servers
Category Developer Tools
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security0
- No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.Unverified
- Known CVEs could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified
- Install-script risk not yet assessed.Unverified
- Dependency health could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified
Provenance & Transparency10
- Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: no license is declared. See how to fix → Fail
- Actively maintained (last published 54 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability52
- AI-judged instruction clarity (fair).Partial
- Context-footprint check failed: tool/resource definitions use about 3341 tokens (~107/item across 31 items; 31 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage67
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 31 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 32 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Nov 26 +1
- Provenance: unverified → fail ▼ security
- Security disclosure: unverified → pass ▲ functional
- 3 Nov 26 −1
- Provenance: fail → unverified ▼ security
- Security disclosure: pass → unverified ▼ functional
- 1 Nov 26 +1
- Stability: 0.97 → pass security
- 31 Oct 26 −1
- Stability: pass → 0.97 functional
- 25 Oct 26 +1
- Stability: 0.97 → pass security
- 24 Oct 26 −1
- Stability: pass → 0.97 functional
- 18 Oct 26 +1
- Stability: 0.97 → pass security
- 16 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed oci/ghcr.io/yubinbin32-ops/mdflow:0.3.7
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | oci |
| Reason | No attestation published |
Background: How many MCP packages publish verified provenance →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
architecture_connect ~101
Connect two architecture Blocks with a validated Link in one simple call without crafting manual operations.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| contract | string | – | – |
| includeStructured | boolean | – | – |
| kind | string | – | – |
| label | string | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| sourceId | string | yes | – |
| targetId | string | yes | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
architecture_link_suggest ~61
Suggest high-confidence architectural links for an architecture Block based on AST source imports and layered conventions.
| Name | Type | Req | Description |
|---|---|---|---|
| blockId | string | yes | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
block_seal ~111
Seal a verified Block implementation as complete. Requires valid current SourceBindings and a fresh passed direct Checkpoint; an executionId, when supplied, must be a successful receipt cited by that Checkpoint.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| blockId | string | yes | – |
| checkpointId | string | – | – |
| executionId | string | – | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
chain_code_stream ~98
Return locator-only source indexes along a Chain: path, symbol, signature, derived line range, source status, and contract. Never returns implementation bodies.
| Name | Type | Req | Description |
|---|---|---|---|
| chainId | string | yes | – |
| includeStructured | boolean | – | – |
| maxLinesPerSymbol | integer | – | – |
| maxTotalChars | integer | – | – |
| mode | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
change_set_revert ~124
Create a new reverse ChangeSet for a safe, fully reversible update-only ChangeSet. Original History is preserved; stale or unsupported changes are rejected instead of partially reverted.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| chainScopeId | string | – | – |
| changeSetId | string | yes | – |
| gitHead | string|null | – | – |
| includeStructured | boolean | – | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| task | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
changes_since ~84
Read only graph/checkpoint mutations after a known change sequence. Use this for live synchronization and compact read-back instead of reloading the project.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| limit | integer | – | – |
| projectRoot | string | – | – |
| sequence | integer | – | – |
| sourceSyncRevision | integer | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
checkpoint_list ~132
List checkpoints by status, target, Plan or ChainScope, including standalone checkpoints that are not referenced by any Plan. Use this for a compact verification inbox instead of opening every entity.
| Name | Type | Req | Description |
|---|---|---|---|
| chainScopeId | string | – | – |
| includeStructured | boolean | – | – |
| limit | integer | – | – |
| locale | string | – | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| status | string | – | – |
| targetId | string | – | – |
| targetType | string | – | – |
| taskContextId | string | – | – |
| unassignedOnly | boolean | – | – |
No output schema declared.
No examples provided.
checkpoint_record ~212
Create or update a checkpoint with evidence. Passed checkpoints are the only basis for healthy completion states.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| aggregationPolicy | object | – | – |
| chainScopeId | string | – | – |
| checkpointKind | string | – | – |
| coverage | string | – | – |
| criteria | string | – | – |
| eligibleAfterChildren | boolean | – | – |
| evidence | array | – | – |
| evidenceExecutionIds | array | – | – |
| evidenceLevel | string | – | – |
| expectedRevision | integer | – | – |
| gitHead | string|null | – | – |
| id | string | – | – |
| includeStructured | boolean | – | – |
| invalidatedAt | string|null | – | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| requiredEvidenceLevel | string | – | – |
| status | string | yes | – |
| targetId | string | yes | – |
| targetType | string | yes | – |
| taskContextId | string | – | – |
| title | string | yes | – |
No output schema declared.
No examples provided.
checkpoint_refresh_candidates ~70
List stale checkpoints that a recorded execution receipt can refresh. Does not auto-pass checkpoints; it only maps changed bindings onto retest_required items.
| Name | Type | Req | Description |
|---|---|---|---|
| executionId | string | – | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
context_for_task ~95
Get a budgeted Markdown context pack for the current development task. Use at task start and expand only selected refs.
| Name | Type | Req | Description |
|---|---|---|---|
| budgetChars | integer | – | – |
| focusRefs | array | – | – |
| includeStructured | boolean | – | – |
| locale | string | – | – |
| maxChars | integer | – | – |
| projectRoot | string | – | – |
| task | string | yes | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
decision_list ~74
Read the compact project-scoped Decision index. Bodies, rationale, alternatives, and consequences are omitted; use decision_open or entity_open(type=decision) for one record.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
decision_open ~77
Open one architecture Decision. Returns its rationale, alternatives, consequences, scope, supersession, and compact History.
| Name | Type | Req | Description |
|---|---|---|---|
| historyLimit | integer | – | – |
| id | string | yes | – |
| includeStructured | boolean | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
entity_open ~82
Open one Block, Chain, Link, Plan, or Decision with only relevant details and recent History.
| Name | Type | Req | Description |
|---|---|---|---|
| historyLimit | integer | – | – |
| id | string | yes | – |
| includeStructured | boolean | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
| type | string | yes | – |
No output schema declared.
No examples provided.
foundation_plan_create ~151
Generate one Foundation Plan from every non-deprecated unimplemented Block. Because this is an explicit implementation/verification Plan, the operation creates missing atomic Block checkpoints, direct Block PlanChanges, dependency-ordered parallel steps, Chain integration gates, and a final Plan acceptance gate in one transaction; plain architecture-only create_block does not.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| gitHead | string|null | – | – |
| goal | string | – | – |
| id | string | – | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| requiredEvidenceLevel | string | – | – |
| taskContextId | string | – | – |
| title | string | – | – |
No output schema declared.
No examples provided.
graph_flow ~93
Declare architectural flows and pipelines using natural arrow expressions like 'block:A -> block:B -> block:C' or 'A -[calls]-> B'. Automatically creates or updates links without complex JSON crafting.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| flow | string | yes | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
graph_mutate ~209
Atomically create or patch Blocks, project-scoped Decisions, global Links, Chain paths, independent Plans, atomic Checkpoints, Background scopes, Decision scopes, and source refs. Decisions are not Canvas Blocks and never enter Block/Chain/Plan coverage. A plain create_block records architecture only; use create_checkpoint in the same ChangeSet when a requirement, Plan, Chain gate, or explicit verification request makes the check necessary. Link kinds are flows_to, calls, reads, writes, depends_on, implements, validates, constrains, and supersedes. Keep each call small and provide expectedRevision for updates.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| chainScopeId | string | – | – |
| gitHead | string|null | – | – |
| includeStructured | boolean | – | – |
| operations | array | yes | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| reason | string | yes | – |
| task | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
graph_patch ~130
Apply a compact mdflow/1 Markdown-like patch. The server expands it into the same atomic ChangeSet used by graph_mutate, preserves omitted fields, and can create an atomic Block checkpoint with checkpoint=auto.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| chainScopeId | string | – | – |
| gitHead | string|null | – | – |
| includeStructured | boolean | – | – |
| patch | string | yes | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| task | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
graph_search ~80
Search graph entities and source paths without loading the entire project.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| kinds | array | – | – |
| limit | integer | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| query | string | yes | – |
| states | array | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
graph_status ~62
Inspect project architecture health, live drift detection, isolated blocks, ghost blocks with code, and pending verification gates.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
graph_validate ~54
Validate global graph references, Chain paths, Plan targets, Background scopes, contracts, and checkpoint-backed completion.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
log_sanitize ~94
Sanitize build, test, or terminal command outputs. Strips ANSI noise, collapses routine compiler stdout, and isolates actionable failure stack traces to protect context window from token flooding.
| Name | Type | Req | Description |
|---|---|---|---|
| exitCode | integer | – | – |
| includeStructured | boolean | – | – |
| maxChars | integer | – | – |
| projectRoot | string | – | – |
| rawOutput | string | yes | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
plan_context ~97
Read one Plan as a compact hierarchical development document: overview, ordered ChainScopes, inline Block/Link/Chain changes, checkpoint gates, and exact source refs. This is the primary read before implementing a Plan.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | – |
| includeStructured | boolean | – | – |
| locale | string | – | – |
| maxChars | integer | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
project_map ~68
Read a compact project map with architecture coverage, ordered Plans, Chain paths, explicit integration gates, and source-sync status without loading entity bodies.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| locale | string | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
project_register ~67
Register an existing directory as an mdflow project. This creates only .mdflow/project.json and is idempotent when the descriptor already exists.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | – | – |
| includeStructured | boolean | – | – |
| name | string | – | – |
| projectRoot | string | yes | – |
No output schema declared.
No examples provided.
run_command ~109
Run one project-local command and return only a redacted, compressed terminal summary. Raw stdout/stderr never enters the MCP response; use this gateway for tests, builds, and mutation verification.
| Name | Type | Req | Description |
|---|---|---|---|
| command | string | yes | – |
| cwd | string | – | – |
| executionKind | string | – | – |
| includeStructured | boolean | – | – |
| maxChars | integer | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
| timeoutMs | integer | – | – |
No output schema declared.
No examples provided.
source_binding_accept ~90
Persist explicitly selected AST source binding candidates for a Block. Every candidate is re-resolved against current source before a SourceRef is created.
| Name | Type | Req | Description |
|---|---|---|---|
| actor | string | – | – |
| bindings | array | yes | – |
| blockId | string | yes | – |
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| reason | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
source_binding_suggest ~87
Suggest source bindings for a Block from AST symbols and project semantics. Suggestions are read-only; use source_binding_accept to persist an explicitly chosen candidate.
| Name | Type | Req | Description |
|---|---|---|---|
| blockId | string | yes | – |
| includeStructured | boolean | – | – |
| limit | integer | – | – |
| maxFiles | integer | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
source_sync ~79
Scan current files for bound symbols without loading source into the response. Reports moved, changed, missing, or ambiguous bindings and affected Blocks/Chains.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| includeUnchanged | boolean | – | – |
| projectRoot | string | – | – |
| sinceRevision | integer | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
step_advance ~95
Advance the active step of a Plan to complete, automatically updating progress and pointing nowDoing to the next step.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| nextStepId | string | – | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| status | string | – | – |
| stepId | string | – | – |
| summary | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
timeline_sync ~105
Synchronize development cursor and active focus across conversations. Updates nowDoing, nextUp, and active step in the timeline.
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| lastFinished | string | – | – |
| nextUp | string | – | – |
| nowDoing | string | – | – |
| planId | string | – | – |
| projectRoot | string | – | – |
| stepId | string | – | – |
| taskContextId | string | – | – |
| touchedFiles | array | – | – |
No output schema declared.
No examples provided.
timeline_view ~68
Read the unified project Timeline: execution phases, ordered plans (P0 > P1 > P2), and current active cursor (nowDoing, nextUp, lastFinished).
| Name | Type | Req | Description |
|---|---|---|---|
| includeStructured | boolean | – | – |
| projectRoot | string | – | – |
| taskContextId | string | – | – |
No output schema declared.
No examples provided.
How do I install the mdflow — Context OS for AI Coding Agents MCP server?
mdflow — Context OS for AI Coding Agents runs locally as a container image, launched with docker run --rm -i -e MDFLOW_PROJECT_ROOT ghcr.io/yubinbin32-ops/mdflow:0.3.7. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.
oci · ghcr.io/yubinbin32-ops/mdflow:0.3.7
claude mcp add yubinbin32-ops-mdflow -- docker run --rm -i -e MDFLOW_PROJECT_ROOT ghcr.io/yubinbin32-ops/mdflow:0.3.7
This image reads MDFLOW_PROJECT_ROOT. Set it in your client's env block for this server; docker run -e passes it through to the container.
What is the mdflow — Context OS for AI Coding Agents MCP server?
mdflow — Context OS for AI Coding Agents is an MCP server listed in the public MCP registry as io.github.yubinbin32-ops/mdflow. Context OS for AI coding agents: task-scoped AST context, verified mutation, and rollback. This page covers its container image (ghcr.io/yubinbin32-ops/mdflow:0.3.7).
Is the mdflow — Context OS for AI Coding Agents MCP server safe to use?
mdflow — Context OS for AI Coding Agents scores 41 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the mdflow — Context OS for AI Coding Agents MCP server expose?
mdflow — Context OS for AI Coding Agents exposes 31 tools: project_register, project_map, decision_list, decision_open, chain_code_stream, and 26 more. Their descriptions and schemas cost roughly 3,059 tokens of context every time the server is loaded.
Is the mdflow — Context OS for AI Coding Agents MCP server still maintained?
mdflow — Context OS for AI Coding Agents is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.