{"id":"io.umtri/umtri","slug":"io-umtri-umtri","title":"Umtri","description":"Give your AI agent a persistent map of your project's structure, dependencies, and bugs.","version":"1.7.1","publisher":{"kind":"domain","id":"umtri.io","label":"umtri.io","url":"https://umtri.io"},"website":"https://docs.umtri.io","repository":"https://github.com/bepuljang/umtri-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.umtri.io"}],"packages":[{"registryType":"npm","identifier":"umtri-mcp","version":"1.7.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Personal access token from app.umtri.io → Settings → API Tokens. Read tokens cannot call write tools.","isRequired":true,"format":"string","isSecret":true,"name":"UMTRI_API_TOKEN"},{"description":"Override the API base URL. Defaults to https://api.umtri.io — set only when self-hosting.","format":"string","name":"UMTRI_API_BASE"}]}],"published":"2026-11-06","updated":"2026-11-06","status":"online","auth":"","latency_ms":1723,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_projects","title":"List grounds (projects)","description":"Returns all grounds the authenticated user can access, with latest activity timestamp. Use this first to discover slugs for other tools. By default returns a summary view — each ground carries slug, name, isActive, transplanting, nodeCount, openBugs, seasonCount, nowSeasonLabel, latestActivityAt, plus a 200-char description excerpt. A ground that belongs to a team also carries org (the team slug) ","read_only":false},{"name":"get_graph","title":"Get the graph of a ground","description":"Returns the tree(nodes), edges, apis, seasons, and bugs for one ground. The tree is the project's information-structure (IA) diagram — each node is a structural element (an object, or an action it performs), not a work-log entry. Node types follow the plant metaphor: trunk → limb → twig → leaf → vein. See resource umtri://rules/vocabulary. By default returns a summary view — nodes carry id/label/t","read_only":false},{"name":"get_impact","title":"Trace the blast radius of a node or bug","description":"Walks the connection graph (edges + apis) from a start node — or a bug's target — to find which other nodes a problem would reach. This is the tool for \"if this breaks / I change this, what else do I need to check?\" and for QA scoping. Impact does NOT always flow with the arrow. direction=\"affected\" (default) answers \"if the start breaks, who is hurt?\" and follows: dependency edges backward (targe","read_only":false},{"name":"list_bugs","title":"List bugs of a ground","description":"Scans the bugs (issues eroding the ground) of one ground. Looking at ONE bug you already know the number/id of? Call get_bug instead — no need to list. Bugs default to status=\"active\" (wild + chasing): a healed bug is history, and history is not what a scan is for. Ask for \"resolved\" or \"all\" when you actually want it. Status speaks the product's own words — wild (found, nobody on it) → chasing (s","read_only":false},{"name":"get_bug","title":"Get one bug of a ground","description":"Returns a single bug by reference — the cheap path when you already know which bug you mean. `ref` accepts either the human-facing number shown in the UI (seq — \"14\" or #14) or the internal id (bug-<uuid>), so a human saying \"#8\" needs no listing at all. Unlike list_bugs this ignores status: a resolved bug is still readable by number, which is how you review what a past fix actually did. Use list_","read_only":false},{"name":"list_seasons","title":"List seasons of a ground","description":"Returns the seasons (time epochs) of a ground in chronological order. A season is the human's declaration that a chapter closed. You may create one with create_season, but only after the user confirms it — see umtri://rules/seasons. By default returns a summary view (id, label, state, startedAt, grownAt). Pass view=\"full\" to also include metadata.","read_only":false},{"name":"export_ground","title":"Export a whole ground as JSON","description":"Returns everything in a ground as one JSON document — project, seasons, nodes (removed ones included, with removedAt), edges, apis, bugs and wiki pages with full bodies. For backups, moving off Umtri, or answering \"can I take my data out?\" (yes — see umtri://about/data). The result is large; save it to a file rather than summarising it, and do not call it for ordinary reads (use get_graph).","read_only":false},{"name":"list_events","title":"List change history of a ground","description":"Returns the append-only change history (most recent first) of a ground: node/edge/api/bug create, update (with a field-level diff {from,to}), delete, and plan_commit. Each event carries the actor (\"user:<id>\" for humans, \"token:<id>\" for agents/automation), a summary label, and for updates a diff. Use it to answer \"what changed, when, and by whom\" — e.g. a bug's status transitions or a node's edit","read_only":false},{"name":"create_bug","title":"Report a bug on a ground","description":"Creates a new bug (issue eroding the target). target.kind = \"node\" or \"api\" requires target.id of an existing node/api in the ground. target.kind = \"ground\" attaches the bug to the project itself (no id). score = change risk on a 0–8 scale (8 = riskiest). It blends functional impact with fix difficulty (a harder fix is likelier to break things, so it ranks higher within a tier). 0: no risk — idea ","read_only":false},{"name":"create_project","title":"Create a new ground (project)","description":"Creates a new ground. Slug must match /^[a-z0-9][a-z0-9-]{0,49}$/ and be unique. By default it goes into the authenticated user's personal space; pass org (a team slug, as list_projects shows it) to create it in a team — only the team's owner can. Requires a write-scope token.","read_only":false},{"name":"create_season","title":"Create a new season","description":"Creates a new season and makes it the \"now\" season. This is not an additive act: the ground's current now-season is sealed as past and every node in it is marked grown, which locks that node's parent/season/type/sproutedAt. CONFIRMATION GATE: call once WITHOUT confirm to get back what would be sealed, put that to the user in your own words, and call again with confirm:true only after they say yes.","read_only":false},{"name":"create_node","title":"Create a node in a ground","description":"Creates a node. Follows the plant vocabulary protocol — see umtri://rules/vocabulary. type ∈ trunk · limb · twig · leaf · vein. Role is derived (structure / object / action). Build leaf-first: when adding a leaf/vein, create only the missing trunk/limb/twig ancestors on its path, then the leaf — do NOT pre-build every trunk, then every limb, then leaves (see Build order in umtri://rules/vocabulary","read_only":false},{"name":"update_node","title":"Update a node","description":"Partial update of a node. Patchable fields: label, type, parent, season, description, tags, metadata, sproutedAt. metadata is merged key by key: only the keys you send change, keys you leave out (commits that record_commit accumulated, transplanted, and so on) are kept, and a key sent as null is removed. So to change implements, send just { metadata: { implements: [...] } }. Type change reclassifi","read_only":false},{"name":"delete_node","title":"Soft-delete a node","description":"Sets removed_at on the node. By default this tool rejects deletion if the node has any active descendant, so a subtree is never lost silently. To soft-delete the node together with all its active descendants, pass cascade=true — only when the human asked to remove the whole branch; soft-deleted nodes cannot be restored. The response lists the cascaded ids. EXCEPTION — while the ground is transplan","read_only":false},{"name":"commit_plan","title":"Commit a realized plan node","description":"Promotes a plan node (metadata.plan=true) to the real tree by clearing the plan flag. VERIFICATION GATE: the node must already carry metadata.implements (the source path(s) you wrote) — without it the commit is rejected, because an uncommitted plan node with no implements is not considered realized. Call this only after you have actually written the code and recorded implements via update_node. Co","read_only":false},{"name":"record_commit","title":"Record a git commit onto the nodes it touched","description":"Configuration record (CI/CD). Given a commit SHA and the files it changed, finds nodes whose metadata.implements include any of those files and appends the commit (sha + timestamp + optional message) to their metadata.commits (deduped by sha). Returns the matched node ids. When one commit touches several nodes that are NOT yet connected, the response also carries coChangeCandidates[] ({a, aLabel, ","read_only":false},{"name":"create_edge","title":"Create an edge between two nodes","description":"Creates a directed edge (source → target) for a STRUCTURAL relation: type \"dependency\" (A is built on / needs B) or \"data_flow\" (data moves A → B outside a request). Use for module/library deps, a route depending on the data store, a job writing a table. For a runtime request/call/integration use create_api instead, not an edge. Reserve connections for relations a maintainer would trace — don't wi","read_only":false},{"name":"delete_edge","title":"Delete an edge","description":"Removes an edge from the ground. Use to retire dependencies/flows that no longer reflect reality.","read_only":false},{"name":"create_api","title":"Create an API flow between two nodes","description":"Records an API flow (start → end) for a RUNTIME request / call / data flow: a screen calling an endpoint, an endpoint hitting a table, an external integration (payment, SMS, webhook). Direction is caller → callee. APIs are first-class (apis table), not generic edges — for a build-time/structural reliance use create_edge (dependency) instead. Add the flows a maintainer would trace; don't wire every","read_only":false},{"name":"update_api","title":"Update an API entry","description":"Partial update of an API. Patchable fields: label, description, metadata, start, end.","read_only":false},{"name":"delete_api","title":"Soft-delete an API entry","description":"Sets removed_at on the API. History is preserved — the API can still be seen in past season views via the time slider.","read_only":false},{"name":"update_bug","title":"Update a bug","description":"Partial update of a bug. Most common use: status transition. Send only the fields that actually change. A status transition is patch:{status} alone — do not re-send an unchanged solution, description, or metadata. Those fields carry prose, and re-emitting them costs far more time than the update itself and risks a malformed-argument retry. Follow the lifecycle one step at a time: open (wild) → in_","read_only":false},{"name":"delete_bug","title":"Delete a bug (hard delete)","description":"Permanently removes a bug record. Bugs do not have history — once deleted, the record is gone. For \"I resolved this\", use update_bug with status=\"resolved\" instead, so the tree remembers what was eroded.","read_only":false},{"name":"send_feedback","title":"Send feedback about Umtri itself","description":"Files a suggestion or a defect report about **Umtri the product** — this MCP server, its tools, the app, the docs. This is NOT for issues in the user's own project: those are bugs on a ground (create_bug). Call this ONLY when the human explicitly asks to leave feedback (\"건의해줘\", \"report this to Umtri\"). Do not file feedback on your own initiative — an inbox filled by agents stops being read. kind: ","read_only":false},{"name":"list_feedback","title":"List feedback filed about Umtri","description":"Lists feedback filed about **Umtri the product** (see send_feedback) — not the bugs of any ground. Umtri operators only: every other account gets 403, so do not call this to check on feedback you filed. Newest first. Status: open (untouched) → done (handled) / wontfix (declined, with the reason in note). Defaults to every status; pass status to narrow. Use limit to bound a scan.","read_only":false},{"name":"update_feedback","title":"Update filed feedback","description":"Updates one feedback record about **Umtri the product** — typically closing it: status=\"done\" once it shipped, or \"wontfix\" when it was declined. Put what was actually done (or why not) in note; that is the part worth reading a year later. Umtri operators only: every other account gets 403. Send only the fields that change. Requires a write-scope token.","read_only":false},{"name":"list_wiki","title":"List wiki pages of a ground","description":"Lists the ground's wiki — the prose the tree cannot hold: conventions, decisions and why they were made, glossary, onboarding. Reference entries describing how things work, not a log of what happened: the change record is list_events, the page's own past is in its revisions. Not the structure itself (get_graph) and not defects (list_bugs). Bodies come back as 200-char excerpts by default so a scan","read_only":false},{"name":"get_wiki","title":"Read one wiki page — in full, as an outline, one section, or the lines around a phrase","description":"Returns one wiki page. `ref` takes either the page slug (what a human says) or the internal id (wiki-<uuid>) — renaming a page changes its slug but never its id, so ids stay safe to store. Every response carries rev (the current revision, what you pass as baseRev when you write) and bodyChars. By default the whole body comes back. **Pages run long (tens of thousands of characters); do not read one","read_only":false},{"name":"list_wiki_revisions","title":"List the revision history of a wiki page","description":"Returns what this page said before, newest first — rev number, who wrote it, when, and the body length. Bodies are not included (a history of twenty full documents is expensive to skim); read one with get_wiki rev=<n>. Use it to answer \"what did this say last week\", to see whether a write of yours dropped something, and to find the rev to hand back to write_wiki mode=\"restore\". Consecutive writes ","read_only":false},{"name":"write_wiki","title":"Create or update a wiki page","description":"Writes one wiki page. Creates it if the page slug is new, updates it otherwise — you do not need to check first. **The wiki is the project's encyclopedia: one page is one entry, and its body is the current spec and rules of that thing.** It is a tree read front to back: an overview page at the top, chapter pages under it, entries under those — place every page with parent (a page slug or id) and p","read_only":false},{"name":"edit_wiki","title":"Change one passage of a wiki page","description":"Replaces one passage of an existing wiki page without resending the body. Pass the exact text to replace (oldString) and what it becomes (newString) — the same contract as a code editor's Edit: oldString must occur **exactly once** on the page. If it is missing, or occurs more than once, nothing is written and the error says which; copy the text verbatim from get_wiki (whitespace and line breaks c","read_only":false},{"name":"delete_wiki","title":"Delete a wiki page","description":"Permanently removes a wiki page **and its whole revision history** — unlike an overwrite, this cannot be undone, and only the history entry (list_events) remains to say it happened. Prefer rewriting a page that went stale over deleting it: a page that records a decision you have since reversed is worth keeping with the reversal written in. Deleting is for a page that should never have existed, not","read_only":false}],"server_info":{"name":"umtri-mcp","version":"1.7.1"},"category":"productivity","tags":["project","agents","travel"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-30","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-umtri-umtri/"}