umtri-mcp
Registry code: c75c537e43d3cecf
Umtri maps a project's structure as a tree (trunk → limb → twig → leaf → vein) and tracks how it changes over seasons. Start with list_projects, then get_graph.
Umtri never reads git. A commit reaches the ground only because something called create_node / update_node / record_commit — so the tree drifts behind the code unless the repo has a habit that says otherwise. If this repo's own rules file (CLAUDE.md, AGENTS.md, …) has no commit-sync policy, read umtri://rules/commit-sync and offer the human a short one to paste in.
- endpoint
- https://mcp.umtri.io
- protocol
- http-sse ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is umtri-mcp live?
- Yes — it answered the hub's last check (checked 13h ago). It answered 100% of checks over the last 30 days.
- Is umtri-mcp free to use?
- Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
- What tools does umtri-mcp have?
- 32 tools: get_bug, delete_bug, list_events, create_bug, create_season, delete_node, record_commit, create_edge, ….
- Is umtri-mcp safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 100%· all time 100%
last good check
of 32 tools
- unknown → live
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
delete_bug auth-required never probed
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.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id" ], "properties": { "id": { "type": "string", "minLength": 1 }, "slug": { "type": "string", "minLength": 1 } }, "additionalProperties": false }arguments 19 lineslist_events auth-required never probed
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 edits over time. Filter with entityType/entityId to get a single entity's timeline. Note: git commits recorded via record_commit live in a node's metadata.commits, not here.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "limit": { "type": "integer", "maximum": 200, "description": "Max events to return (default 50, cap 200).", "exclusiveMinimum": 0 }, "before": { "type": "string", "description": "ISO timestamp — return events strictly older than this (keyset pagination)." }, "entityId": { "type": "string", "description": "Filter to one entity's timeline (usually paired with entityType)." }, "entityType": { "enum": [ "node", "edge", "api", "bug" ], "type": "string", "description": "Filter to one entity type." } }, "additionalProperties": false }arguments 39 linescreate_bug auth-required never probed
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 / memo. 1: no risk — copy / wording edit. 2: no functional error, but may change usability. 3: minor functional issue possible — simple fix. 4: minor — complex fix. 5: significant functional issue possible — simple fix. 6: significant — complex fix. 7: critical functional issue possible — simple fix. 8: critical — complex fix. Defaults to 4. Urgency is intentionally NOT part of this score. status defaults to "open". solution is the fix, and it belongs to agents — the app gives people no way to edit it, so a human's own proposed fix arrives in description instead. At report time solution holds the plan, and by the time the bug is resolved it should describe what was actually applied. Same field — overwrite it as understanding changes; project_events keeps the diff. Write what remains as "- [ ] item" lines so the app can render them as cards and later moves cost one small op (update_bug patch:{solutionItem}). Leave it empty rather than guessing. For a node/api bug, the response auto-attaches impact (the affected blast radius from the target): reachedCount, the reached nodes with hop distance and the connection each was reached through, other active bugs sitting in that radius, and a coverage note. Use it to scope what else to check/QA. If the target has no recorded connections the radius is empty — that means nothing is recorded, not that nothing is affected (record edges/apis). Requires a write-scope token. See umtri://rules/vocabulary for bug semantics.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "title", "target" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "score": { "type": "integer", "maximum": 8, "minimum": 0, "description": "Change risk 0–8 (8 = riskiest: critical impact × complex fix). Defaults to 4. See tool description for the rubric." }, "title": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Short summary of the bug. Required." }, "status": { "enum": [ "open", "in_progress", "resolved", "closed" ], "type": "string", "description": "Defaults to \"open\"." }, "target": { "type": "object", "required": [ "kind" ], "properties": { "id": { "type": "string", "description": "Required when kind is \"node\" or \"api\"." }, "kind": { "enum": [ "node", "api", "ground" ], "type": "string", "description": "Where the bug attaches." } }, "description": "Bug target. Use {kind:\"ground\"} when the bug is about the project as a whole.", "additionalProperties": false }, "solution": { "type": "string", "description": "How to fix it. At report time this is the plan/idea; update it to what was actually applied when you resolve. Markdown allowed. Omit if you do not know yet." }, "description": { "type": "string", "description": "Longer details on what is wrong (markdown allowed)." } }, "additionalProperties": false }arguments 70 linescreate_season auth-required never probed
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. Never pass confirm:true on your own judgment — a season is the human's declaration that one chapter closed and the next began, and inventing one makes the ground's timeline meaningless. Unsure which season a node belongs to? Attach it to the existing now-season instead of opening a new one. See umtri://rules/seasons.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "label" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "label": { "type": "string", "minLength": 1, "description": "Season label the human chose — a version, phase, or period (e.g. \"1.0.0\", \"PoC\", \"Q3 2026\")." }, "confirm": { "type": "boolean", "description": "Pass true ONLY after the user has agreed to this exact season. Omit it on the first call to receive the confirmation payload instead." } }, "additionalProperties": false }arguments 25 linesdelete_node auth-required never probed
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 transplanting (project.transplanting=true), the active-descendant guard is lifted (subtree cascade allowed) and you may pass hard=true to permanently remove import mistakes, including grown (past-season) nodes. Once the human roots the ground, normal guards return.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "Node id." }, "hard": { "type": "boolean", "description": "Permanently delete (incl. descendants via FK cascade) instead of soft-delete. Only honored while the ground is transplanting; irreversible — use for import cleanup." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "cascade": { "type": "boolean", "description": "Also soft-delete every active descendant. Without it, a node with active children is rejected." } }, "additionalProperties": false }arguments 29 linesrecord_commit auth-required never probed
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, b, bLabel}) — nodes that change together are dependency candidates; review them and add a create_edge/create_api where a real relation exists (not auto-created; suppressed for large multi-node commits; pass coChange=false to skip them entirely when nobody will review, e.g. a CI step that only records). Umtri does not run jobs or read git itself — a GitHub Action / CI step or an agent supplies the sha+files. Recording a commit is the LAST step: first make sure the change is in the tree (new unit → create_node with metadata.implements; moved file → update_node), otherwise the sha lands on the nodes that happen to exist and the new ones stay invisible. A repo that keeps forgetting should write the habit down — see umtri://rules/commit-sync. See also umtri://rules/plan.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "sha", "files" ], "properties": { "sha": { "type": "string", "minLength": 1, "description": "Commit SHA (short or full)." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "files": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Repo-relative paths changed by the commit, matched against nodes' metadata.implements." }, "message": { "type": "string", "description": "Commit message (optional, stored with the record)." }, "coChange": { "anyOf": [ { "type": "boolean" }, { "enum": [ "true", "false" ], "type": "string" } ], "description": "Default true. false skips coChangeCandidates — for callers that record every commit and never review the suggestions." } }, "additionalProperties": false }arguments 49 linescreate_edge auth-required never probed
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 wire everything. type ∈ project.edge_types; same source and target is rejected. See umtri://rules/system-structure (Connections).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "source", "target", "type" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "type": { "type": "string", "minLength": 1, "description": "Edge type — required. \"dependency\" (source is built on / needs target) or \"data_flow\" (data moves source → target) — use one of the ground's edgeTypes." }, "label": { "type": "string" }, "source": { "type": "string", "minLength": 1, "description": "Source node id." }, "target": { "type": "string", "minLength": 1, "description": "Target node id." }, "metadata": { "type": "object", "additionalProperties": {} } }, "additionalProperties": false }arguments 40 lineslist_wiki auth-required never probed
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 stays cheap; pass body="full" only when you mean to read them, or body="none" for a pure index. A page may hang off a node (nodeId) or float free — pass node=<id> for one node's pages, or node="none" for the pages not yet attached to anything, which is the list worth reviewing when the tree has grown. The wiki is a tree: each page has a parent page and a position among its siblings, starting from an overview page. order="tree" returns the whole table of contents in reading order (depth-first, with depth) — use it to read the wiki front to back or to see where a new page belongs. Every page also has a kind (overview / concept / component / rule / glossary); kind="none" lists the pages not yet classified.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "body": { "enum": [ "none", "excerpt", "full" ], "type": "string", "description": "How much body text per page. Default \"excerpt\" (200 chars)." }, "kind": { "enum": [ "overview", "concept", "component", "rule", "glossary", "none" ], "type": "string", "description": "Only pages of this kind, or \"none\" for unclassified pages. Omit for all." }, "node": { "type": "string", "description": "Node id to filter by, or \"none\" for pages attached to nothing yet. Omit for all." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "limit": { "type": "integer", "exclusiveMinimum": 0 }, "order": { "enum": [ "asc", "desc", "tree" ], "type": "string", "description": "\"desc\" (default) / \"asc\" by last update, or \"tree\" for the table of contents in reading order." } }, "additionalProperties": false }arguments 53 linesget_graph auth-required never probed
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/type/parent/season, plus a 200-char description excerpt, metadata.implements, placeholder/dormant flags (soft-deleted nodes are omitted). Pass view="full" only when you need timestamps, full descriptions, all metadata keys, or tags — that response is ~3× larger. For a large tree, read it in slices instead of all at once: rootId (+depth) for one trunk or limb; maxType for a layer (e.g. maxType="twig" = the skeleton without leaves/veins — a cheap overview); role for a cross-section; season for what was born in one season. Filters combine. Node ids come from the graph itself, so the standard drill-down is two calls: first get_graph with maxType="trunk" (or "limb") for a cheap skeleton, find the id you want, then call again with rootId set to it to get just that trunk/limb and its subtree. Control the heaviest field with descriptions: "none" drops descriptions for a pure structural overview, "excerpt" (default) gives a 200-char preview, "full" returns them verbatim when you drill into a limb. The summary response also carries shape (nodeCount, maxDepth, nodes-per-level, over-wide branches) so you can judge whether the tree is too deep or too wide without rebuilding it, a childCount on each branch node, and iaHints flagging structural smells. A bushy tree (mass at mid-levels) is healthy — don't over-nest sparse parents into twigs. Bugs default to active (open + in_progress) — pass bugStatus="all" to also see healed (resolved/closed) ones. Nodes may carry plan:true — these are the human's node-based brief (intent drawn as structure, not a prompt); read them as instructions and realize them (see umtri://rules/plan). When you slice (rootId/maxType/role/season), a connection with only ONE endpoint inside the slice is still returned, marked boundary:true, and its outside endpoint appears as a lightweight stub in externalNodes (id/label/type/role, external:true) — so cross-branch dependencies and calls never silently vanish from a slice. To follow one, call get_graph again with rootId set to that external id. The response also carries project.transplanting — when true the ground is still being transplanted (see umtri://rules/transplant): you may freely add/edit nodes in any season incl. past, and hard-delete import mistakes. project.seedMeta is the ground's intent when the human filled it in — goal, endDate, budget, audience. No tool writes it, so it is the human's own brief for what this tree is for: read it before you propose or reshape structure, and let it settle what belongs in the tree and what does not.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "role": { "enum": [ "structure", "object", "action" ], "type": "string", "description": "Cross-section by role (structure=trunk/limb/twig, object=leaf, action=vein). Parents may fall outside the result." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug (from list_projects)." }, "view": { "enum": [ "summary", "full" ], "type": "string", "description": "summary (default) for compact nodes; full for raw shape with all fields." }, "depth": { "type": "integer", "minimum": 0, "description": "With rootId: how many levels below the root to include (0 = just the root, 1 = root + direct children). Omit for the whole subtree." }, "rootId": { "type": "string", "description": "Scope to this node and its descendants — read one trunk or limb at a time. Get the id from a prior get_graph (e.g. maxType=\"trunk\" for a cheap skeleton). Bugs are scoped to the subtree; edges/apis that cross the subtree boundary are still returned (boundary:true) with their outside endpoint in externalNodes." }, "season": { "type": "string", "description": "Born-in delta — return only nodes that first appeared in this season (season id from list_seasons): what grew that season." }, "maxType": { "enum": [ "trunk", "limb", "twig", "leaf", "vein" ], "type": "string", "description": "Layer ceiling — return only nodes at this level or higher (trunk is highest). maxType=\"twig\" yields the structural skeleton without leaves/veins. Great for a cheap overview before drilling in with rootId." }, "bugStatus": { "enum": [ "active", "wild", "chasing", "resolved", "all", "open", "in_progress", "closed" ], "type": "string", "description": "Which bugs to include. Default \"active\" = wild + chasing (open + in_progress) — resolved ones are healed erosion, noise on the tree. \"wild\" for the untouched only, \"resolved\" for healed, \"all\" for every bug. Raw DB statuses still work. Use list_bugs for richer bug queries (limit/order), get_bug for one you can name." }, "descriptions": { "enum": [ "none", "excerpt", "full" ], "type": "string", "description": "How much of each node/bug description to include in summary view: none (drop them — lightest structural read), excerpt (200-char preview, default), or full (verbatim). Ignored when view=\"full\" (always verbatim)." } }, "additionalProperties": false }arguments 79 linesget_impact auth-required never probed
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 (target→source), data_flow edges forward (source→target), apis backward (callee→caller). direction="dependsOn" is the reverse ("what does the start rely on?"). direction="both" unions them. See umtri://rules/system-structure (How problems propagate). Provide exactly one start: node (a node id) or bug (a bug id — starts from its target node, or both endpoints if the bug is on an api; ground-level bugs are rejected). Traversal is over CURRENT (live) structure only. Returns reached[] (each with hops distance, the node `from` which it was reached, and the connection `via` it came through — so you can reconstruct the chain), bugs[] (active bugs sitting on any reached node/api, worst score first), and coverage. IMPORTANT: the result is a list of nodes to CHECK, not a proven failure set — it is only as complete as the connections recorded. coverage.startsWithoutConnections flags when the start has no connections at all: an empty result then means "nothing recorded," not "nothing affected" — record edges/apis first.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "bug": { "type": "string", "description": "Start from this bug's target. Provide this OR node." }, "node": { "type": "string", "description": "Start node id. Provide this OR bug." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "maxDepth": { "type": "integer", "minimum": 0, "description": "Max hops to traverse. Omit for unbounded." }, "direction": { "enum": [ "affected", "dependsOn", "both" ], "type": "string", "description": "affected (default): what breaks if the start breaks. dependsOn: what the start relies on. both: union." } }, "additionalProperties": false }arguments 37 lineslist_projects auth-required 13h ago
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) and role (owner/editor/reporter/viewer) — a viewer can read but every write tool returns 403 there; a reporter can only create_bug and update_bug. A ground with wiki pages also carries wikiCount — prose the tree cannot hold (conventions, decisions, glossary); read it with list_wiki. Pass view="full" for all fields (seedMeta — the ground's human-written intent: goal, endDate, budget, audience — plus typeCounts, raw metadata, timestamps); the icon base64 in metadata is always stripped (UI-only).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "view": { "enum": [ "summary", "full" ], "type": "string", "description": "summary (default) for a compact list; full for every field." } }, "additionalProperties": false }arguments 15 lineslist_bugs auth-required never probed
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 (someone is fixing it) → resolved (it landed) — the same words the UI shows. Each bug has a score (0–8 change-risk; 8 = riskiest), and any bug whose solution carries a checklist also carries solutionProgress ("2/5" — ticked/total), so you can see what is left without opening a single body. Targets: a node, an api, or the ground itself. By default returns a summary view — each bug carries id, seq (the number a human says, "#14"), target, title, score, status, createdAt/resolvedAt, plus a 200-char description excerpt. Each node/api bug also carries impactCount — how many other nodes its target reaches by blast radius (affected direction), so you can spot wide-blast bugs at a glance; call get_impact on that bug for the full reached list. Pass view="full" for full descriptions and metadata. Use limit + order to bound a scan (e.g. the 5 newest) instead of pulling every bug.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "view": { "enum": [ "summary", "full" ], "type": "string", "description": "summary (default) for a compact list; full for verbatim descriptions + metadata." }, "limit": { "type": "integer", "description": "Return at most this many bugs (applied after the status filter). Omit for all matching.", "exclusiveMinimum": 0 }, "order": { "enum": [ "asc", "desc" ], "type": "string", "description": "By creation time: \"asc\" oldest first (default), \"desc\" newest first. Pair with limit for \"the N newest\"." }, "status": { "enum": [ "active", "wild", "chasing", "resolved", "all", "open", "in_progress", "closed" ], "type": "string", "description": "Which bugs to include. Default \"active\" = wild + chasing (open + in_progress). \"wild\" = found but untouched, \"chasing\" = someone is on it, \"resolved\" = healed (resolved + closed), \"all\" = every bug. The raw DB statuses are accepted too; note \"open\" means wild + chasing there (REST semantics), so pass \"wild\" when you want only the untouched ones." } }, "additionalProperties": false }arguments 50 lineslist_seasons auth-required never probed
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.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "view": { "enum": [ "summary", "full" ], "type": "string", "description": "summary (default) drops UI-only metadata; full includes it." } }, "additionalProperties": false }arguments 23 linesexport_ground auth-required never probed
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).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." } }, "additionalProperties": false }arguments 15 linescreate_project auth-required never probed
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.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "name" ], "properties": { "org": { "type": "string", "minLength": 1, "description": "Team slug to create the ground in. Omit for your personal space. You must own the team." }, "name": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Display name." }, "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,49}$", "description": "URL slug. Lowercase letters, digits, hyphens; 1–50 chars." }, "description": { "type": "string" } }, "additionalProperties": false }arguments 30 linescreate_node auth-required never probed
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). Aim for a faithful, COMPLETE map of the project, not a summary: every meaningful module/screen/endpoint/table/integration should become a node (grouped at the information-unit grain, not one-per-file). A real project yields many leaves — under-capturing to a few nodes is the more common mistake. See Completeness in umtri://rules/system-structure. parent ∈ existing node id; omit to create a root-level node. season ∈ existing season id; omit to use the active "now" season. Past seasons are normally rejected, but allowed while the ground is transplanting (project.transplanting=true) — nodes added then are auto-stamped metadata.transplanted=true for audit. See umtri://rules/transplant. The tool validates against protocol policies. Hierarchy violations are rejected. Soft issues (reserved-domain labels, leaf↔vein heuristic, trunk naming) come back as warnings in the response — reconsider before continuing if warnings appear. A trunk carries metadata.kind ∈ front · server · database · library · device · tooling, and its limbs follow that kind's axis: same domain name across trunks with no suffix ("예약", not "예약 API"), no technical-layer limbs, and at most one common limb (metadata.common=true). Read umtri://rules/trunk-kinds before creating a trunk or a limb under one. After creating a leaf/vein, consider its connections: if it calls/feeds another node add an api (create_api), if it depends on/is built on another add an edge (create_edge). The response carries a connectionCheck reminder. See umtri://rules/system-structure (Connections). Do not open a new season just because none fits — attach to the now-season, or ask the user. create_season needs their confirmation (umtri://rules/seasons). When realizing a human-drawn plan brief, any detail nodes you add should carry metadata.plan=true and the realized node needs metadata.implements — see umtri://rules/plan. A trunk is never plan: metadata.plan on a trunk is rejected.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "type", "label" ], "properties": { "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "tags": { "type": "array", "items": { "type": "string" } }, "type": { "type": "string", "minLength": 1, "description": "Node type. Use trunk/limb/twig/leaf/vein per the metaphor." }, "label": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Node label, visible in the tree." }, "parent": { "type": "string", "description": "Parent node id. Omit for root-level (a new trunk)." }, "season": { "type": "string", "description": "Season id. Omit to use the active \"now\" season." }, "metadata": { "type": "object", "description": "Free-form metadata. For `leaf` and `vein`, set `metadata.implements` to an array of file paths (or `path#identifier` for multi-export files) — this is how the graph maps concept → code and is expected on essentially every leaf/vein. Use `metadata.placeholder=true` for intentionally-empty structure.", "additionalProperties": {} }, "sproutedAt": { "type": "string", "format": "date-time", "description": "Effective creation time (ISO 8601 with offset, e.g. \"2024-03-15T09:00:00Z\"). Omit to use the current moment. Use only when back-filling history of a project that existed before Umtri — e.g. importing past commits or migrating a tree. The visualization timeline (sibling order, season visibility, events) follows this value." }, "description": { "type": "string" } }, "additionalProperties": false }arguments 55 linesupdate_node auth-required never probed
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 reclassifies role; parent change recomputes the ltree path automatically. On a grown (past-season) node, only the tree's shape and timeline are locked — parent, season, type and sproutedAt are rejected. Content fields (label, description, metadata, tags) stay editable, so you can keep metadata.implements current when code moves without reopening transplanting. Moving any node into a `past` season is rejected. Both restrictions lift while the ground is transplanting (project.transplanting=true), so historical structure can be reconstructed (see umtri://rules/transplant). Same protocol validation as create_node — reject on hierarchy violations, warn on soft issues.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id", "patch" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "Node id." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "patch": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string" } }, "type": { "type": "string", "minLength": 1 }, "label": { "type": "string", "maxLength": 200, "minLength": 1 }, "parent": { "type": [ "string", "null" ], "description": "New parent id, or null to detach to root." }, "season": { "type": [ "string", "null" ], "description": "New season id, or null to detach from any season. Past seasons are rejected." }, "metadata": { "type": "object", "description": "Keys to change — merged into the existing metadata. null removes a key. Keys you omit are kept.", "additionalProperties": {} }, "sproutedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "description": "Effective creation time (ISO 8601 with offset). Set to null to clear and fall back to the system timestamp. Use only for back-filling historical projects." }, "description": { "type": [ "string", "null" ] } }, "description": "Only the fields you want to change.", "additionalProperties": false } }, "additionalProperties": false }arguments 81 linescommit_plan auth-required never probed
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. Commit from the top down: a node whose parent is still a plan is rejected — commit the parent first. See umtri://rules/plan.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "Plan node id to commit." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." } }, "additionalProperties": false }arguments 21 linesdelete_edge auth-required never probed
Removes an edge from the ground. Use to retire dependencies/flows that no longer reflect reality.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "Edge id." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." } }, "additionalProperties": false }arguments 21 linescreate_api auth-required never probed
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 everything. start/end must be existing node ids. See umtri://rules/system-structure (Connections).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "start", "end" ], "properties": { "end": { "type": "string", "minLength": 1, "description": "Target node id." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "label": { "type": "string" }, "start": { "type": "string", "minLength": 1, "description": "Source node id." }, "metadata": { "type": "object", "additionalProperties": {} }, "description": { "type": "string" } }, "additionalProperties": false }arguments 37 linesupdate_api auth-required never probed
Partial update of an API. Patchable fields: label, description, metadata, start, end.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id", "patch" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "API id." }, "slug": { "type": "string", "minLength": 1 }, "patch": { "type": "object", "properties": { "end": { "type": "string" }, "label": { "type": "string" }, "start": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": {} }, "description": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "additionalProperties": false }arguments 46 linesdelete_api auth-required never probed
Sets removed_at on the API. History is preserved — the API can still be seen in past season views via the time slider.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id" ], "properties": { "id": { "type": "string", "minLength": 1 }, "slug": { "type": "string", "minLength": 1 } }, "additionalProperties": false }arguments 19 linesupdate_bug auth-required never probed
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_progress (chasing) → resolved. Set status="in_progress" the moment you start the fix, not after it lands — it is the only marker that someone is already on this bug, so a parallel agent can see the work in flight instead of duplicating it. Then set "resolved" once it ships. Skipping straight from open to resolved returns a warning (not a rejection) — acceptable when the fix was genuinely instant. Other patchable fields: title, description, solution, score (0–8 change-risk), metadata. solution is yours to maintain — the app does not let people edit it, so what you write is what the human reads. Their own proposed fix arrives in description instead. Keep solution as a checklist: prose for what you learned, "- [ ] item" lines for what remains. To move one item use patch:{solutionItem:{…}} instead of re-sending the whole field — add: "text", or check/uncheck/remove: <1-based item number>. Pass expect:"<start of that item text>" alongside a number so a shifted list fails loudly instead of ticking the wrong line. This is the cheap path: one short op, not a re-emitted body. When resolving, rewrite solution to what you actually applied — at report time it held the plan, and leaving a stale plan there is worse than leaving it empty. To mark a bug as fixed, prefer status="resolved" over delete — that preserves the history of what eroded the tree. When resolving, you may record the shipped release in metadata.resolvedVersion (e.g. "v2.3.1"); metadata is replaced wholesale, so include existing keys you want to keep.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "id", "patch" ], "properties": { "id": { "type": "string", "minLength": 1, "description": "Bug id." }, "slug": { "type": "string", "minLength": 1 }, "patch": { "type": "object", "properties": { "score": { "type": "integer", "maximum": 8, "minimum": 0, "description": "Change risk 0–8 (8 = riskiest). See create_bug for the rubric." }, "title": { "type": "string", "maxLength": 200, "minLength": 1 }, "status": { "enum": [ "open", "in_progress", "resolved", "closed" ], "type": "string" }, "metadata": { "type": "object", "additionalProperties": {} }, "solution": { "type": [ "string", "null" ], "description": "How it is being / was fixed — prose plus \"- [ ] item\" lines. Rewrite it to the actually-applied fix when you set status=\"resolved\"; a stale plan left behind is worse than an empty field. null clears it. Replaces the whole field — to move a single item use solutionItem." }, "description": { "type": [ "string", "null" ], "description": "What is wrong." }, "solutionItem": { "type": "object", "properties": { "add": { "type": "string", "minLength": 1, "description": "Append a new unchecked item." }, "check": { "type": "integer", "description": "Tick item #N (1-based, counting items only).", "exclusiveMinimum": 0 }, "expect": { "type": "string", "description": "Guard for check/uncheck/remove: the start of that item's text. Mismatch is rejected, so a reordered list cannot silently tick the wrong line." }, "remove": { "type": "integer", "description": "Delete item #N.", "exclusiveMinimum": 0 }, "uncheck": { "type": "integer", "description": "Untick item #N.", "exclusiveMinimum": 0 } }, "description": "Move ONE checklist item without re-sending solution. Cannot be combined with solution.", "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }arguments 96 linessend_feedback auth-required never probed
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: "bug" = something in Umtri is broken or wrong; "improvement" = a suggestion / wish (default). source: where it surfaced — the ground slug you were working in, the tool name that felt wrong, the screen. It is free text and is not validated, but it is what makes a report actionable later. One-way: this files the report, and there is no reading it back — do not promise the human a status thread. Requires a write-scope token.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "title" ], "properties": { "body": { "type": "string", "description": "Details — what you expected, what happened, why it matters (markdown allowed)." }, "kind": { "enum": [ "bug", "improvement" ], "type": "string", "description": "\"bug\" for something broken in Umtri, \"improvement\" for a suggestion. Defaults to \"improvement\"." }, "title": { "type": "string", "maxLength": 200, "minLength": 1, "description": "One-line summary. Required." }, "source": { "type": "string", "maxLength": 200, "description": "Where it came up: ground slug, tool name, or screen." } }, "additionalProperties": false }arguments 33 linesupdate_feedback auth-required never probed
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.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "id" ], "properties": { "id": { "type": "integer", "description": "Feedback number, as returned by send_feedback / list_feedback.", "exclusiveMinimum": 0 }, "body": { "type": "string" }, "kind": { "enum": [ "bug", "improvement" ], "type": "string" }, "note": { "type": "string", "description": "What was done about it, or why it was declined." }, "title": { "type": "string", "maxLength": 200, "minLength": 1 }, "source": { "type": "string", "maxLength": 200 }, "status": { "enum": [ "open", "done", "wontfix" ], "type": "string", "description": "open → done (handled) / wontfix (declined)." } }, "additionalProperties": false }arguments 47 linesget_wiki auth-required never probed
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 in full to answer a small question.** view="outline" returns the lead paragraph and the heading tree (path like "1.2", level, heading, line, chars per section) — start there on a page you have not seen. section="<heading text or path>" returns just that section (through its sub-headings), plus the footnote definitions it references; it must match exactly one heading, and on an ambiguous match the error lists the candidates with their paths. find="<text>" returns the lines containing the text (case-insensitive, literal) with context lines around each, merged into blocks with line numbers — a block is ready to be the oldString of edit_wiki. find inside one section: pass both. Read in full before write_wiki mode="replace" — it overwrites the body wholesale, and an outline is not the body. For a one-passage fix, find or section the spot and call edit_wiki instead. Pass rev=<n> to read an older revision instead of the current page (list them with list_wiki_revisions; outline/section/find work there too). To put an old revision back, do not paste its body into a write — use write_wiki mode="restore", which cannot mangle the prose in transit.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "ref" ], "properties": { "ref": { "type": "string", "minLength": 1, "description": "Page slug (e.g. \"deploy-notes\") or id (wiki-<uuid>)." }, "rev": { "type": "integer", "description": "Revision number to read. Omit for the current page.", "exclusiveMinimum": 0 }, "find": { "type": "string", "minLength": 1, "description": "Literal text to look for (case-insensitive). Returns matching lines with context, merged into blocks with line numbers. With section, searches inside that section only." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "view": { "enum": [ "full", "outline" ], "type": "string", "description": "\"full\" (default) returns the body; \"outline\" returns the lead and the heading tree with sizes instead. Ignored when section or find is given." }, "context": { "type": "integer", "maximum": 10, "minimum": 0, "description": "Lines of context around each find match. Default 2." }, "section": { "type": "string", "minLength": 1, "description": "One heading, by its text (case-insensitive; backticks/emphasis ignored) or by its outline path (\"1.2\"). Returns that section and its sub-sections only." } }, "additionalProperties": false }arguments 50 lineslist_wiki_revisions auth-required never probed
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 by the same actor within 30 minutes fold into one revision rather than piling up, so the list stays readable — a working session is one entry, not eight. The practical guarantee: whatever an agent does to a page in one session, the body from before that session is still a separate revision. Revisions start at the moment the ground gained this feature; edits older than that were never recorded and cannot be recovered.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "ref" ], "properties": { "ref": { "type": "string", "minLength": 1, "description": "Page slug or id." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "limit": { "type": "integer", "exclusiveMinimum": 0 }, "order": { "enum": [ "asc", "desc" ], "type": "string", "description": "By revision number. Default \"desc\" (newest first)." } }, "additionalProperties": false }arguments 33 lineswrite_wiki auth-required never probed
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 position (its order among siblings), and check list_wiki order="tree" to see where it belongs. For a new wiki, follow the table of contents in umtri://templates/wiki. The title is a plain noun for the thing in the reader's language (조직, 배포, Billing) — no dash, colon, parenthetical or sentence; the description goes in the lead. Give every page a kind — overview (the top page and chapter pages that introduce what is under them), concept (a product/domain concept or model), component (how one part of the system works), rule (a convention that must be kept), glossary (the project's vocabulary). Write it to this skeleton: a lead paragraph first (1–3 sentences saying what the thing is — not a heading, quote or list), then "## 스펙" / "## Spec" (how it works now; break it down with ###), then "## 규칙" / "## Rules" (invariants, prohibitions, required order). concept and component need Spec; rule needs Rules; overview and glossary are free-form after the lead. No other top-level (##) sections. Background, history, rejected alternatives and side notes go into footnotes — [^name] in the text, [^name]: … at the end — not into the body. A reason stays in the body only if someone changing the code would get it wrong without it. Write what the tree cannot hold and what a maintainer would otherwise have to reconstruct: why a decision went the way it did, the vocabulary this project uses, what an investigation concluded. Do not restate the structure — that is what nodes are for. **A page is a description, not a log.** Write it in the present tense, as a reference entry for the thing: how it works now, and the reasons that still constrain it. Do not append what you just did, do not add dated entries or a change-history section, do not keep progress checklists here — those go to bugs, plan nodes, list_events, and record_commit, and the page's own past is already kept in its revisions. When something changes, rewrite the sentence that is now wrong rather than adding a sentence saying it changed. mode="replace" (default) overwrites the whole body — read the page first, or you will drop what was there; this is the normal way to rewrite a page. **To change one passage of an existing page, use edit_wiki instead** — it takes the exact text and its replacement, so a one-line fix on a long page does not resend the whole body. mode="append" is the narrow case: adding a section the page genuinely lacked, never tacking on this session's summary. mode="restore" puts an earlier revision back: pass rev=<n> and nothing else, and the page returns to what it said then. node attaches the page to a node; omit it and the page floats free, which is fine and common early on. Attach it later once the tree has a place for it. Deleting that node detaches the page rather than deleting it. Every write is kept as a revision, so a replace that drops prose can be undone (list_wiki_revisions, then mode="restore"). Consecutive writes by the same actor within 30 minutes fold into one revision instead of piling up, which means the body from before your session stays recoverable as its own revision no matter how many times you rewrite the page now. Pass newRevision=true when the page moves to a new stage rather than being polished further — most importantly when you first write back what you actually built over a page that until now held the plan. Folding is judged by clock and author, which cannot tell "still drafting" from "the plan became the thing"; only you know that, and without the flag the plan is quietly overwritten by its own outcome. rename moves the page to a new slug, keeping its id and its whole revision history — do not create a new page and delete the old one, that throws the history away. The response tells you what the write did: rev is the revision it landed in, coalesced says whether it folded into your previous one, and previousBodyChars is how long the body was before you wrote. If previousBodyChars is much larger than what you just wrote, you replaced someone's work — check list_wiki_revisions before moving on. The body itself is not echoed back — bodyChars is its length now; re-read with get_wiki if you need the text. baseRev is optional and is how you avoid clobbering a concurrent edit: pass the rev you read, and the write is refused if the page moved on since. Use it when you read, think, then write. The response carries warnings[] when the page strays from the skeleton or reads like a log (status banners, dated headings, checklists, change-history sections, unmatched footnotes). The write is saved either way — fix what they point at and write again. The change also lands in the ground's history (list_events, entityType="wiki"), where the body is recorded as a length delta rather than a copy of the prose — the prose itself lives in the revisions. Requires a write-scope token.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "page" ], "properties": { "rev": { "type": "integer", "description": "With mode=\"restore\": the revision number to bring back (from list_wiki_revisions).", "exclusiveMinimum": 0 }, "body": { "type": "string", "description": "Markdown body. With mode=\"append\" this is the text to add. Ignored by mode=\"restore\"." }, "kind": { "anyOf": [ { "enum": [ "overview", "concept", "component", "rule", "glossary" ], "type": "string" }, { "type": "null" } ], "description": "Page kind — decides the required sections. Give it when creating. Omit to keep the current kind." }, "mode": { "enum": [ "replace", "append", "restore" ], "type": "string", "description": "\"replace\" (default) overwrites the body — the normal way to update a page; \"append\" adds a missing section to the end (not a session summary); \"restore\" brings back the revision named by rev." }, "node": { "type": [ "string", "null" ], "description": "Node id to attach to. null detaches. Omit to leave the current attachment untouched." }, "page": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,79}$", "description": "Page slug — lowercase letters, digits, hyphens. The name humans use, e.g. \"deploy-notes\"." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "title": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Display title. Required when creating a page." }, "parent": { "type": [ "string", "null" ], "description": "Parent page (slug or id) — where this page sits in the table of contents. null moves it to the top level (only overview pages belong there). Omit to keep it." }, "rename": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,79}$", "description": "New page slug. Keeps the id and the revision history; refused if that name is taken." }, "baseRev": { "type": "integer", "description": "The revision you based this write on. If the page has moved past it, the write is refused instead of overwriting.", "exclusiveMinimum": 0 }, "position": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Order among siblings under the same parent (ascending; pages without one come after, by title). Omit to keep it." }, "newRevision": { "anyOf": [ { "type": "boolean" }, { "enum": [ "true", "false" ], "type": "string" } ], "description": "Force a new revision instead of folding into the last one. Use when this write ends one stage of the page and begins another — above all when replacing a plan with what was actually built." } }, "additionalProperties": false }arguments 113 linesedit_wiki auth-required never probed
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 count) or include more surrounding text to make it unique. newString="" deletes the passage. Matching is literal, not a regex. This is the normal way to fix a sentence, update a value, or correct one rule on a page that already exists. Use write_wiki when you are composing a page or rewriting several sections at once, and mode="append" there when a section is genuinely missing. The edit is a revision like any other write: it folds into your previous write within 30 minutes unless newRevision=true, and baseRev refuses the edit when the page moved on since you read it. The response carries rev, coalesced, previousBodyChars and bodyChars, plus warnings[] when the page as a whole now strays from the skeleton — not the body. Requires a write-scope token.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "page", "oldString", "newString" ], "properties": { "page": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,79}$", "description": "Page slug of an existing page." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "baseRev": { "type": "integer", "description": "The revision you read. If the page has moved past it, the edit is refused.", "exclusiveMinimum": 0 }, "newString": { "type": "string", "description": "The replacement text. \"\" deletes the passage." }, "oldString": { "type": "string", "minLength": 1, "description": "The exact text to replace. Must occur exactly once on the page." }, "newRevision": { "anyOf": [ { "type": "boolean" }, { "enum": [ "true", "false" ], "type": "string" } ], "description": "Force a new revision instead of folding into your last write." } }, "additionalProperties": false }arguments 52 linesdelete_wiki auth-required never probed
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 for one that is out of date.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "ref" ], "properties": { "ref": { "type": "string", "minLength": 1, "description": "Page slug or id." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." } }, "additionalProperties": false }arguments 21 lineslist_feedback auth-required 13h ago
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.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "kind": { "enum": [ "bug", "improvement" ], "type": "string", "description": "Filter by kind. Omit for both." }, "limit": { "type": "integer", "description": "Return at most this many.", "exclusiveMinimum": 0 }, "order": { "enum": [ "asc", "desc" ], "type": "string", "description": "By creation time. Default \"desc\" (newest first)." }, "status": { "enum": [ "open", "done", "wontfix" ], "type": "string", "description": "Filter by status. Omit for all." } }, "additionalProperties": false }arguments 37 linesget_bug unknown 13h ago
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_bugs only to scan for bugs you cannot yet name. The response carries the full description and metadata, plus impact — the blast radius reached from the bug's target (reachedCount, the reached nodes with hop distance, and other active bugs sitting in that radius). Numbers are per-ground and never reused, so a deleted bug leaves a gap rather than shifting the others. Returns an error if no bug matches.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "slug", "ref" ], "properties": { "ref": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "integer", "exclusiveMinimum": 0 } ], "description": "Bug number (seq, e.g. 14) or internal id (bug-<uuid>)." }, "slug": { "type": "string", "minLength": 1, "description": "Ground slug." }, "solution": { "enum": [ "none", "open", "full" ], "type": "string", "description": "How much of solution to return. Default \"full\". \"open\" returns only the unchecked items and drops the prose — the cheap answer to \"what is left?\"." }, "descriptions": { "enum": [ "none", "excerpt", "full" ], "type": "string", "description": "How much of description to return. Default \"full\". Use \"none\"/\"excerpt\" when you only came for the solution checklist." } }, "additionalProperties": false }arguments 47 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's idc75c537e43d3cecf.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/c75c537e43d3cecf/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/c75c537e43d3cecf?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.