katra
A committed markdown dev log and task graph that agents read and write.
Connector by craigjmidwinter · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/craigjmidwinter-katra
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 4 read · 8 write · 0 delete · 3 not yet classified
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Docker image
Tools by what they do 15
Read from the source code; the running server may list different tools.
Read 4 · Look things up without changing anything.
katra_getkatra_listkatra_nodeskatra_task_list
Write 8 · Create, change, send or run things.
katra_appendkatra_article_newkatra_decidekatra_epic_newkatra_newkatra_task_newkatra_task_set_statuskatra_task_spec
Not yet classified 3 · We could not tell from the name and description.
katra_capturekatra_comparekatra_stamp
Files it touches
- Any path the agent passes to its tools
Tools (15)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
katra_appendAppend markdown to a draft. Defaults to the active draft if slug is omitted. Rich components are fenced code blocks: ```embed, ```compare, ```gallery, ```video, ```note, ```warning.
katra_article_newCreate a new article (evergreen reference) node. Returns its slug.
katra_captureImport a media file (image/gif/video/html) into the dev log and append it to a draft. Use this for screenshots, animation gifs, and interactive html artifacts.
katra_compareImport two images and append a before/after comparison slider to a draft.
katra_decideCreate a new decision (ADR) node. Returns its slug.
katra_epic_newCreate a new epic node. Returns its slug.
katra_getGet one entry's frontmatter and raw markdown body by slug.
katra_listList dev log entries (newest first). Returns slug, title, date, draft status, hashes and tags.
katra_newCreate a new draft entry. Returns its slug. Write the *why*, not a paraphrased diff.
katra_nodesList nodes of a given type (newest first). Returns slug, title, type, date, status and other node-model fields. Omit type to list every node type.
katra_stampStamp a draft with its commit hash(es) + computed diffstat, moving it from In Progress into the log. Defaults to HEAD and the active draft.
katra_task_listList task nodes (newest first). Optionally filter by status.
katra_task_newCreate a new task node (status defaults to todo, or specced when spec is given). Returns its slug.
katra_task_set_statusSet a task's status (todo|specced|doing|done|cut).
katra_task_specAttach a spec artifact to a task. Advances todo/empty status to specced; leaves doing/done/cut alone (setting spec never moves status backwards). A ref that resolves to neither a node nor a file warns but still writes — `katra doctor` is the blocking check, not this.
Signals
- Stars
- 0
- Forks
- 1
- Open issues
- 0
- Last commit
- Sep 13, 2026 (1 month ago)
- Last release
- Aug 26, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.craigjmidwinter/katra- Version
- 0.1.0
- Auth
- No auth
- Packages
- oci
ghcr.io/craigjmidwinter/katra-mcp:0.1.0 - License
- MIT
- Repository
- github.com/craigjmidwinter/katra
- Website
- midwinter.io/katra/
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from craigjmidwinter
- 0.524score
katra
craigjmidwinter
Chronicle development work in a committed, rich-component dev log as you build.
SkillBFreshness: BClaude Code +9 - 0.500score
mail-muncher
craigjmidwinter
Filtered, read-only IMAP and Gmail archived to disk as.eml + markdown, served.
ConnectorBFreshness: BLocal★ 3Claude Code +5
Cite this page
katra MCP server. Agent Mart. https://agentmart.dev/connectors/craigjmidwinter-katra (last updated 2026-10-25)