Server definition
- Hash
- sha256:89690a9e5bf74d50c32c5f42032b6958219490ed20a34640b0eae793cc336139
- What it is
- What a remote MCP server returned when asked what it offers: 33 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Create a new Pathrule workspace inside an organization. Cloud-only: writes the workspace row through the user's JWT (RLS enforces organization membership). Does NOT attach the workspace to a local folder, does NOT install any AI client config, and does NOT render CLAUDE.md/AGENTS.md or editor companion files — those steps require Pathrule Studio or CLI. After creation, call pathrule_setup with the returned workspace_id to fetch the bootstrap brief.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"active_agent_targets": {
"description": "AI clients this workspace will be used from. Affects Desktop/CLI companion file rendering when those surfaces attach. Defaults to ['claude-code'].",
"items": {
"enum": [
"claude-code",
"cursor",
"windsurf",
"codex",
"copilot"
],
"type": "string"
},
"type": "array"
},
"git_remote_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional git remote URL (HTTPS or SSH form). Stored for reference and surface matching; never used to access the user's machine."
},
"name": {
"description": "Human-readable workspace name (e.g. the project / repo display name).",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"organization_id": {
"description": "Organization UUID from pathrule_list_organizations.",
"format": "uuid",
"type": "string"
}
},
"required": [
"organization_id",
"name"
],
"type": "object"
},
"name": "pathrule_create_workspace",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "The created workspace row.",
"properties": {
"active_agent_targets": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "AI clients this workspace is configured for."
},
"created_at": {
"description": "Creation timestamp in ISO 8601.",
"type": "string"
},
"git_remote_url": {
"description": "Stored git remote URL, or null.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Workspace name as stored.",
"type": "string"
},
"organization_id": {
"description": "Organization the workspace was created under.",
"type": "string"
},
"workspace_id": {
"description": "UUID of the new workspace. Pass it to pathrule_setup next.",
"type": "string"
}
},
"required": [
"workspace_id",
"name",
"organization_id",
"git_remote_url",
"active_agent_targets",
"created_at"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"next_step": {
"description": "The call to make next, as { tool, arguments }."
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Soft-delete a memory by default. Pass hard:true to permanently delete (requires workspace_admin). Cloud-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"expected_version_id": {
"description": "Optional optimistic-concurrency token from the existing record. Pass it when available to avoid overwriting a newer edit.",
"format": "uuid",
"type": "string"
},
"hard": {
"description": "False or omitted performs a soft delete. True permanently deletes and requires admin rights.",
"type": "boolean"
},
"memory_id": {
"description": "Memory UUID to delete.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"memory_id"
],
"type": "object"
},
"name": "pathrule_delete_memory",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Deleted memory: id, plus the title it had before deletion."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Soft-delete a rule by default. hard:true requires workspace_admin. Cloud-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"expected_version_id": {
"description": "Optional optimistic-concurrency token from the existing record. Pass it when available to avoid overwriting a newer edit.",
"format": "uuid",
"type": "string"
},
"hard": {
"description": "False or omitted performs a soft delete. True permanently deletes and requires admin rights.",
"type": "boolean"
},
"rule_id": {
"description": "Rule UUID to delete.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"rule_id"
],
"type": "object"
},
"name": "pathrule_delete_rule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Deleted rule: id, plus the name it had before deletion."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Soft-delete a skill by default. hard:true requires workspace_admin. Cloud-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"expected_version_id": {
"description": "Optional optimistic-concurrency token from the existing record. Pass it when available to avoid overwriting a newer edit.",
"format": "uuid",
"type": "string"
},
"hard": {
"description": "False or omitted performs a soft delete. True permanently deletes and requires admin rights.",
"type": "boolean"
},
"skill_id": {
"description": "Skill UUID to delete.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"skill_id"
],
"type": "object"
},
"name": "pathrule_delete_skill",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Deleted skill: id, plus the name it had before deletion."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Return Pathrule context for a workspace path: relevant memories, rules, skills, subtree index, and a next_required_action hint. Remote clients must pass workspace_id; call pathrule_list_workspaces first when unsure. No cwd or local_root_path is used. The response includes a `local_runtime.cta` line — surface it when the user could benefit from Pathrule Studio's hooks, CLAUDE.md/AGENTS.md sync, or on-disk skills.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"known_protocol_version": {
"description": "Pass the protocol_version already cached by the client to omit repeats.",
"minLength": 1,
"type": "string"
},
"node_path": {
"description": "Workspace-relative path such as '/' or '/packages/app'. Defaults to '/'.",
"type": "string"
},
"user_intent": {
"description": "The user's current request, if available.",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id"
],
"type": "object"
},
"name": "pathrule_get_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"description": "Router response. The remaining keys are depth-dependent and come from the shared context handler: memories, rules, skills, subtree_memory_index, discovery_signal, semantic_candidates, and next_required_action are the ones clients rely on, and which of them appear depends on the classified intent.",
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"protocol": {
"description": "Full protocol text. Sent only when the client did not already hold this protocol_version."
},
"protocol_unchanged": {
"const": true,
"description": "Present when known_protocol_version matched, meaning `protocol` was omitted on purpose.",
"type": "boolean"
},
"protocol_version": {
"description": "Version of the Pathrule agent protocol this response was built against. Cache it and pass it back as known_protocol_version.",
"type": "string"
},
"workspace_id": {
"description": "Workspace the context was resolved in.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Explain what Pathrule CLI (power-user, terminal-first) and Pathrule Studio (GUI) unlock beyond Remote MCP. Call this when the user asks 'is there a better way?', 'why do I need to install something?', wants hook-level automation, or wants to compare surfaces. The response splits the pitch by audience (CLI for terminal-first, Pathrule Studio for GUI) and explains the real token-savings angle: hooks fire before every AI tool call and inject context for free, while remote MCP is manual mode where the AI spends tokens on each context fetch.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "pathrule_get_local_runtime_upgrade",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "Surface comparison split by audience.",
"properties": {
"cloud_connector_can": {
"description": "What Remote MCP alone can already do.",
"items": {
"type": "string"
},
"type": "array"
},
"cta": {
"additionalProperties": true,
"description": "Where to send a user who wants the local runtime.",
"properties": {
"label": {
"description": "Call-to-action label.",
"type": "string"
},
"message": {
"description": "One-line upgrade message to relay to the user.",
"type": "string"
},
"url": {
"description": "Download page URL.",
"type": "string"
}
},
"required": [
"label",
"url",
"message"
],
"type": "object"
},
"for_fast_gui_users_desktop": {
"description": "Pitch for GUI users (Pathrule Studio)."
},
"for_power_users_cli_plus_web": {
"description": "Pitch for terminal-first users (Pathrule CLI)."
},
"remote_mcp_stays_useful_for": {
"description": "Cases where Remote MCP remains the right surface."
},
"why_upgrade": {
"description": "The token-cost argument for a local runtime."
}
},
"required": [
"cloud_connector_can",
"cta"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Return a single node plus ids for attached memories, rules, and skills. Requires workspace_id to prevent cross-workspace ambiguity.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"node_id": {
"description": "Tree node UUID.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"node_id"
],
"type": "object"
},
"name": "pathrule_get_node",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"description": "The node detail is spread onto the top level by the shared node handler: the node fields plus the ids of its attached memories, rules, and skills.",
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"workspace_id": {
"description": "Workspace the node belongs to. A node outside the requested workspace is reported as a not_found error instead.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Claim one refresh task and return the subject, stale-signal evidence, AI instructions, and any proposed patch. Call pathrule_list_pending_refreshes first to choose a refresh_id. Remote MCP can inspect cloud records only; use Desktop/CLI before claiming local source code was verified.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"refresh_id": {
"description": "Refresh task UUID from pathrule_list_pending_refreshes.",
"format": "uuid",
"type": "string"
}
},
"required": [
"refresh_id"
],
"type": "object"
},
"name": "pathrule_get_refresh_brief",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"ai_instructions": {
"description": "What to do with this task, written for the agent.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"local_runtime_required": {
"anyOf": [
{},
{
"type": "null"
}
],
"description": "Non-null when the task needs local source inspection that Remote MCP cannot do. Do not claim it was applied in that case."
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"proposed_patch": {
"anyOf": [
{},
{
"type": "null"
}
],
"description": "A pre-drafted patch when one exists, otherwise null."
},
"refresh_id": {
"description": "The refresh task now claimed by this client.",
"type": "string"
},
"signal": {
"description": "Why the item was flagged stale: { formulaId, humanReason, detectedAt, rawSignals }."
},
"status": {
"description": "Task status after the claim.",
"type": "string"
},
"subject": {
"additionalProperties": true,
"description": "The memory or rule this task proposes to update.",
"properties": {
"body": {
"description": "Current body of the subject, before any patch.",
"type": "string"
},
"id": {
"description": "UUID of the memory or rule.",
"type": "string"
},
"node_path": {
"description": "Workspace-relative path the subject lives at.",
"type": "string"
},
"title": {
"description": "Current title or name of the subject.",
"type": "string"
},
"type": {
"description": "What is being refreshed: memory or rule.",
"type": "string"
}
},
"required": [
"type",
"id",
"title",
"node_path",
"body"
],
"type": "object"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Return the full Pathrule node tree for a workspace.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id"
],
"type": "object"
},
"name": "pathrule_get_tree",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nodes": {
"description": "Every node in the workspace tree, each with its id, path, name, and parent linkage.",
"items": {},
"type": "array"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Resolve a path/name/fuzzy target inside a workspace and return full content for that node plus a compact subtree memory index.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"subtree_limit": {
"description": "Maximum entries in the subtree memory index. Defaults to 50, capped at 500. Raise it only when the compact index is genuinely truncated.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"target": {
"description": "Node path, name, or fuzzy target such as '/apps/api' or 'auth'.",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"target"
],
"type": "object"
},
"name": "pathrule_goto",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"memories": {
"description": "Active memories on the node, with full content: id, title, content, source.",
"items": {},
"type": "array"
},
"node": {
"additionalProperties": true,
"description": "The node the target resolved to.",
"properties": {
"name": {
"description": "Node display name.",
"type": "string"
},
"node_id": {
"description": "Tree node UUID for the resolved target.",
"type": "string"
},
"path": {
"description": "Workspace-relative path of the node.",
"type": "string"
}
},
"required": [
"node_id",
"path",
"name"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"rules": {
"description": "Active rules on the node, with full content. Obey these.",
"items": {},
"type": "array"
},
"skills": {
"description": "Active skills on the node, with full content.",
"items": {},
"type": "array"
},
"subtree_memory_index": {
"description": "Compact index of memories below the node: { entries, total, truncated }."
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Import an official Pathrule pattern (a bundle of memories, rules, and skills) into the workspace when the user pastes a `::pathrule:package:<slug>` token. WORKFLOW: (1) First call with `dry_run: true` to see the pattern's `appliesTo` (stacks/packages/paths) and pieces WITHOUT writing. (2) Judge fit against THIS workspace. If it does NOT fit (e.g. an Expo pattern but the project has no Expo), STOP and ask the user whether and where to add it. (3) Choose the `node_path` base matching the user's structure (e.g. /apps/mobile); the pattern's paths re-root under it. (4) Call again without dry_run to write. Path-first + idempotent. Imported skills are tagged `pattern:<slug>`; the response lists each created id. Relay the returned human_message. Use pathrule_remove_pattern to undo. This is a pattern import, NOT a skill — do not run the find-skills protocol.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"dry_run": {
"description": "True returns the pattern's appliesTo + pieces WITHOUT writing. Use first to decide fit + base path.",
"type": "boolean"
},
"node_path": {
"description": "Base path to re-root the whole bundle under, chosen to match this workspace. Omit only when the pattern's own paths already fit.",
"type": "string"
},
"slug": {
"description": "Pattern slug — the part after 'package:' in ::pathrule:package:<slug>.",
"pattern": "^[a-z0-9][a-z0-9-]*$",
"type": "string"
},
"verbose": {
"description": "Set true for per-piece import detail. Default false (compact summary).",
"type": "boolean"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"slug"
],
"type": "object"
},
"name": "pathrule_import_pattern",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"description": "Compact form by default. With verbose=true the full import record is spread onto the top level instead, and dry_run=true returns the same shape with nothing written.",
"properties": {
"applies_to": {
"description": "The pattern's declared fit: stacks, packages, and paths it targets."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"imported": {
"description": "The pieces actually written, grouped by kind (memories, rules, skills)."
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"skipped": {
"description": "Pieces not written, with the reason, for example an item that already existed."
},
"slug": {
"description": "Pattern slug that was imported.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Read-only map of this workspace's memories, rules and skills, grouped into regions by links and meaning. view=atlas: the whole system in under 1k tokens. view=region: one region's items, relations and issues, paged (purpose=audit adds a checklist). view=related: what else to read or update with given item_ids, titles, files or a query. Use before a quality pass, before updating knowledge, or to see how things relate. No confirmation needed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"files": {
"description": "Workspace-relative file paths (view=related).",
"items": {
"maxLength": 480,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"type": "array"
},
"item_ids": {
"description": "Memory, rule or skill ids to start from (view=related).",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"limit": {
"description": "Max related entries (default 8).",
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"page": {
"description": "Region page (view=region).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"purpose": {
"description": "audit appends the audit checklist to region pages.",
"enum": [
"audit",
"browse"
],
"type": "string"
},
"query": {
"description": "Free-text query to start from (view=related).",
"maxLength": 300,
"minLength": 2,
"type": "string"
},
"region_id": {
"description": "Region (rg_) or sub-region (sr_) id from the atlas (view=region).",
"pattern": "^(rg|sr)_[0-9a-f]{8}$",
"type": "string"
},
"titles": {
"description": "Titles or names to start from (view=related).",
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"view": {
"description": "atlas: all regions; region: one region's page; related: neighbours of the given seeds.",
"enum": [
"atlas",
"region",
"related"
],
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"view"
],
"type": "object"
},
"name": "pathrule_knowledge_map",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"algorithm": {
"description": "Map algorithm version; region ids are stable within it.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"page": {
"description": "The page rendered (view=region).",
"type": "number"
},
"pages": {
"description": "Pages in the region (view=region).",
"type": "number"
},
"region_id": {
"description": "The region rendered (view=region).",
"type": "string"
},
"related": {
"description": "Related entries with ids, reasons and scores (view=related).",
"items": {},
"type": "array"
},
"retry_after_ms": {
"description": "When status is computing, how long to wait before calling again.",
"type": "number"
},
"semantic": {
"description": "Where memory similarity came from.",
"enum": [
"voyage",
"local",
"lexical"
],
"type": "string"
},
"status": {
"description": "ready, computing (call again after retry_after_ms) or unavailable.",
"enum": [
"ready",
"computing",
"unavailable"
],
"type": "string"
},
"text": {
"description": "The rendered view.",
"type": "string"
},
"view": {
"description": "The view that was rendered.",
"enum": [
"atlas",
"region",
"related"
],
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "List active memories attached to a specific Pathrule tree node. Use pathrule_get_context, pathrule_goto, or pathrule_get_node first to discover the node_id. Returns compact previews only; call pathrule_read_memory with a memory_id when you need the full body.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"node_id": {
"description": "Tree node UUID returned by pathrule_get_node, pathrule_goto, or the workspace tree.",
"format": "uuid",
"type": "string"
}
},
"required": [
"node_id"
],
"type": "object"
},
"name": "pathrule_list_memories",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"memories": {
"description": "Compact previews only. Read a full body with pathrule_read_memory.",
"items": {
"additionalProperties": true,
"properties": {
"id": {
"description": "Memory UUID. Pass it to pathrule_read_memory for the full body.",
"type": "string"
},
"node_id": {
"description": "Tree node the memory is attached to.",
"type": "string"
},
"preview": {
"description": "First 160 characters of the body, not the full content.",
"type": "string"
},
"title": {
"description": "Memory title.",
"type": "string"
},
"updated_at": {
"description": "Last update timestamp in ISO 8601.",
"type": "string"
}
},
"required": [
"id",
"title",
"preview",
"node_id",
"updated_at"
],
"type": "object"
},
"type": "array"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "List Pathrule organizations the authenticated user belongs to. Use this before pathrule_create_workspace when you need to ask the user which organization the new workspace should live under. Returns id, name, slug, plan, subscription_status and the user's role per org.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "pathrule_list_organizations",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "Organization list and its size.",
"properties": {
"count": {
"description": "Number of organizations returned.",
"type": "number"
},
"organizations": {
"description": "Organizations the authenticated user belongs to.",
"items": {
"additionalProperties": true,
"properties": {
"id": {
"description": "Organization UUID. Pass it to pathrule_create_workspace.",
"type": "string"
},
"name": {
"description": "Organization name.",
"type": "string"
},
"plan": {
"description": "Billing plan identifier.",
"type": "string"
},
"role": {
"description": "The authenticated user's role in this organization.",
"type": "string"
},
"slug": {
"description": "Organization slug.",
"type": "string"
},
"subscription_status": {
"description": "Billing status of the organization.",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"plan",
"subscription_status",
"role"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"organizations",
"count"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "List pending Pathrule refresh tasks for a workspace. Refresh tasks are cloud suggestions that may update stale memories or rules. Use this first, then call pathrule_get_refresh_brief with a returned refresh_id before deciding whether to reject or resolve the task.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"include_in_progress": {
"description": "Include tasks already claimed by a client. Defaults to false for a clean todo list.",
"type": "boolean"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id"
],
"type": "object"
},
"name": "pathrule_list_pending_refreshes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"refreshes": {
"description": "Pending refresh tasks. Each carries a refresh_id for pathrule_get_refresh_brief.",
"items": {},
"type": "array"
},
"total": {
"description": "Number of refresh tasks returned.",
"type": "number"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "List the most recent project snapshots for a workspace (compact metadata only — no file_tree, no sampled_contents). Use to find which snapshot to read in full. Up to 25 per call, ordered newest first.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Default 10, max 25.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"source": {
"description": "Filter to snapshots taken from a specific Pathrule surface.",
"enum": [
"mcp-remote",
"mcp-local",
"cli",
"desktop",
"other"
],
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id"
],
"type": "object"
},
"name": "pathrule_list_snapshots",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "Snapshot metadata list. Load one in full with pathrule_read_snapshot.",
"properties": {
"count": {
"description": "Number of snapshots returned.",
"type": "number"
},
"snapshots": {
"description": "Newest first. Metadata only: id, source, project_name, git_remote_url, branch, git_head, file_count, total_size_bytes, created_at.",
"items": {},
"type": "array"
},
"workspace_id": {
"description": "Workspace the snapshots belong to.",
"type": "string"
}
},
"required": [
"workspace_id",
"count",
"snapshots"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "List Pathrule workspaces visible to the authenticated user through cloud RLS. Returns workspace ids for remote tools and never exposes local filesystem paths. Response includes a `local_runtime.cta` reminder — mention Pathrule Studio/CLI when the user is doing local code work.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "pathrule_list_workspaces",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"count": {
"description": "Number of workspaces returned.",
"type": "number"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"note": {
"description": "Short guidance line about the returned set.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"selection_required": {
"description": "True when the count is not exactly 1, meaning you should ask the user which workspace to use.",
"type": "boolean"
},
"workspaces": {
"description": "Workspaces visible to the authenticated user. Never contains local filesystem paths.",
"items": {
"additionalProperties": true,
"properties": {
"archived": {
"description": "True when the workspace has been archived.",
"type": "boolean"
},
"archived_at": {
"description": "Archive timestamp in ISO 8601, or null.",
"type": [
"string",
"null"
]
},
"frozen": {
"description": "True when billing is unpaid or canceled, which blocks subscription-gated tools.",
"type": "boolean"
},
"name": {
"description": "Workspace name.",
"type": "string"
},
"organization": {
"additionalProperties": true,
"description": "Owning organization and its billing status.",
"properties": {
"id": {
"description": "Organization UUID.",
"type": "string"
},
"name": {
"description": "Organization name, or null when not readable.",
"type": [
"string",
"null"
]
},
"slug": {
"description": "Organization slug, or null when not readable.",
"type": [
"string",
"null"
]
},
"subscription_status": {
"description": "Billing status that decides whether subscription-gated tools will run.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug",
"subscription_status"
],
"type": "object"
},
"workspace_id": {
"description": "Workspace UUID. Pass this to every workspace-scoped tool.",
"type": "string"
}
},
"required": [
"workspace_id",
"name",
"organization",
"archived",
"archived_at",
"frozen"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Log a file-modifying response from a remote MCP client. Remote MCP requires workspace_id and stamps ai_client='cloud-connector'. task_summary should be ONE concise sentence (ideally ≤300 chars); it is NEVER rejected for length (past ~500 chars it is stored auto-shortened, not an error — do not retry).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"action": {
"description": "What was done in this response.",
"enum": [
"create",
"update",
"fix",
"refactor",
"delete",
"style"
],
"type": "string"
},
"domain": {
"description": "Area of the product the work belongs to.",
"enum": [
"ui",
"backend",
"database",
"infra",
"config",
"test",
"docs"
],
"type": "string"
},
"files_touched": {
"additionalProperties": false,
"description": "Which files changed. Tolerant by contract: a malformed value is dropped rather than rejected, so logging never fails on it.",
"properties": {
"by_area": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Workspace-relative file paths grouped by area, for example { \"packages/app\": [\"src/main.ts\"] }. The server normalizes and clamps these.",
"type": "object"
},
"total": {
"description": "Number of files modified in this response.",
"type": "number"
}
},
"type": "object"
},
"node_path": {
"default": "/",
"description": "Workspace-relative path the work happened at, for example /packages/app. Use the most specific path the change actually touched. Defaults to the workspace root.",
"type": "string"
},
"scope": {
"description": "How far the change reached, from a single file up to the whole workspace.",
"enum": [
"component",
"page",
"hook",
"store",
"api",
"migration",
"service",
"model",
"util",
"project"
],
"type": "string"
},
"subjects": {
"default": [],
"description": "Up to 5 short keywords naming what was touched, for example [\"oauth\", \"token-refresh\"].",
"items": {
"type": "string"
},
"type": "array"
},
"task_summary": {
"description": "One concise sentence describing what this response actually changed. Never rejected for length: past the hard maximum it is stored auto-shortened, so do not retry a shorter version.",
"type": "string"
},
"verbose": {
"description": "Return the full stored activity row instead of the compact acknowledgement. Defaults to false.",
"type": "boolean"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"domain",
"action",
"scope",
"task_summary"
],
"type": "object"
},
"name": "pathrule_log_activity",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"activity": {
"description": "The full stored activity row. Present only with verbose=true."
},
"created_at": {
"description": "Insertion timestamp in ISO 8601. Compact form only.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"id": {
"description": "UUID of the stored activity row. Compact form only.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"summary_over_target": {
"description": "True when task_summary exceeded the soft target. The row was still written, so do not retry.",
"type": "boolean"
},
"task_summary_chars": {
"description": "Length of the task_summary that was stored.",
"type": "number"
},
"task_summary_hard_max_chars": {
"description": "Length past which task_summary is stored auto-shortened. Never an error.",
"type": "number"
},
"task_summary_target_chars": {
"description": "Soft target length for task_summary.",
"type": "number"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Sanity check that Pathrule Remote MCP is reachable. Cloud-safe: returns no local cwd. Response includes a `local_runtime.cta` line you can surface to the user when they ask about deeper Pathrule features.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"description": "Optional message to echo back.",
"type": "string"
}
},
"type": "object"
},
"name": "pathrule_ping",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"authenticated": {
"description": "Present and false only on the unauthenticated public ping.",
"type": "boolean"
},
"client_id": {
"description": "OAuth client id of the calling MCP client, or null on an unauthenticated ping.",
"type": [
"string",
"null"
]
},
"cloud": {
"description": "Always true on Remote MCP. Marks the response as cloud-served, with no local cwd.",
"type": "boolean"
},
"echo": {
"description": "The `message` argument echoed back, or null when none was sent.",
"type": [
"string",
"null"
]
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"pong": {
"const": true,
"description": "Present and true when the endpoint answered.",
"type": "boolean"
},
"ts": {
"description": "Server timestamp in ISO 8601.",
"type": "string"
},
"version": {
"description": "Connector build identifier.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Read the full body and metadata for one Pathrule memory. Use this after pathrule_get_context, pathrule_goto, or pathrule_list_memories returns a memory_id. This reads cloud data only and does not inspect the user's local filesystem.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"memory_id": {
"description": "Memory UUID returned by pathrule_get_context, pathrule_goto, or pathrule_list_memories.",
"format": "uuid",
"type": "string"
}
},
"required": [
"memory_id"
],
"type": "object"
},
"name": "pathrule_read_memory",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"content": {
"description": "Full memory body.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"id": {
"description": "Memory UUID.",
"type": "string"
},
"node_path": {
"description": "Workspace-relative path of the node this memory hangs on.",
"type": [
"string",
"null"
]
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"source": {
"description": "How the memory was authored, for example claude or manual.",
"type": "string"
},
"title": {
"description": "Memory title.",
"type": "string"
},
"updated_at": {
"description": "Last update timestamp in ISO 8601.",
"type": "string"
},
"version_id": {
"description": "Optimistic-concurrency token. Pass it as expected_version_id to pathrule_update_memory.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Read the full body and metadata for one Pathrule rule. Use this after pathrule_get_context, pathrule_goto, or pathrule_get_node returns a rule_id. Rules are instructions the AI should obey for a project path; this tool only reads the cloud rule record and does not modify anything.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"rule_id": {
"description": "Rule UUID returned by pathrule_get_context, pathrule_goto, or pathrule_get_node.",
"format": "uuid",
"type": "string"
}
},
"required": [
"rule_id"
],
"type": "object"
},
"name": "pathrule_read_rule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"content": {
"description": "Full rule body: the constraint to obey.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"id": {
"description": "Rule UUID.",
"type": "string"
},
"name": {
"description": "Rule name.",
"type": "string"
},
"node_path": {
"description": "Workspace-relative path the rule applies to.",
"type": [
"string",
"null"
]
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"priority": {
"description": "One of high, medium, or low.",
"type": "string"
},
"scope_type": {
"description": "One of project, folder, or file_type.",
"type": "string"
},
"updated_at": {
"description": "Last update timestamp in ISO 8601.",
"type": "string"
},
"version_id": {
"description": "Optimistic-concurrency token. Pass it as expected_version_id to pathrule_update_rule.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Read the approved snapshot for one Pathrule skill. Use this after pathrule_get_context, pathrule_goto, or pathrule_get_node returns a skill_id. Returns the cloud SKILL.md content for the AI to follow; it does not install or materialize files locally.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"skill_id": {
"description": "Skill UUID returned by pathrule_get_context, pathrule_goto, or pathrule_get_node.",
"format": "uuid",
"type": "string"
}
},
"required": [
"skill_id"
],
"type": "object"
},
"name": "pathrule_read_skill",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"content": {
"description": "Full SKILL.md body, including its frontmatter.",
"type": "string"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"id": {
"description": "Skill UUID.",
"type": "string"
},
"name": {
"description": "Skill name, as invoked with ::name.",
"type": "string"
},
"node_path": {
"description": "Workspace-relative path the skill is attached to.",
"type": [
"string",
"null"
]
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"source": {
"description": "One of manual, template, or github_ref.",
"type": "string"
},
"updated_at": {
"description": "Last update timestamp in ISO 8601.",
"type": "string"
},
"version_id": {
"description": "Optimistic-concurrency token. Pass it as expected_version_id to pathrule_update_skill.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Load a single project snapshot in full or partial form. Defaults include file_tree and sampled_contents — pass include_file_tree=false / include_sampled_contents=false to keep the response compact when you only need metadata.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"include_file_tree": {
"description": "Include the flat file/directory list. Defaults to true. Pass false to keep the response small.",
"type": "boolean"
},
"include_sampled_contents": {
"description": "Include the truncated bodies of the sampled files. Defaults to true. Pass false when you only need metadata.",
"type": "boolean"
},
"snapshot_id": {
"description": "Snapshot UUID from pathrule_list_snapshots.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"snapshot_id"
],
"type": "object"
},
"name": "pathrule_read_snapshot",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "The snapshot row. Which columns are present depends on include_file_tree and include_sampled_contents."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Remove a previously-imported Pathrule pattern bundle in one call — the reverse of pathrule_import_pattern. The pattern definition is the manifest, so this finds and deletes the memories/rules/skills whose titles match the pattern's pieces. Pass the SAME `node_path` base used at import (omit if the pattern's own paths were used). Pieces not found are reported, not errors (idempotent). Relay the returned human_message.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"node_path": {
"description": "The base path the bundle was imported under. Must match the import to locate the pieces.",
"type": "string"
},
"slug": {
"description": "Pattern slug — the part after 'package:' in ::pathrule:package:<slug>.",
"pattern": "^[a-z0-9][a-z0-9-]*$",
"type": "string"
},
"verbose": {
"description": "Set true for per-piece detail. Default false (compact summary).",
"type": "boolean"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"slug"
],
"type": "object"
},
"name": "pathrule_remove_pattern",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"description": "Compact form by default. With verbose=true the full removal record is spread onto the top level instead.",
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"not_found": {
"description": "Pieces the bundle declares that were not present under the given node_path."
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"removed": {
"description": "The pieces actually deleted, grouped by kind."
},
"slug": {
"description": "Pattern slug that was removed.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Close a Pathrule refresh task after reviewing its brief. Normal remote flow: call pathrule_list_pending_refreshes, then pathrule_get_refresh_brief, then use this tool with status='rejected' when the signal is stale or not actionable. Remote MCP may refuse status='applied' because it cannot verify local source files; use Pathrule Studio/CLI for applied resolutions that require local verification.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"note": {
"description": "Short reason for the resolution, especially when rejecting a stale or unsafe refresh.",
"maxLength": 500,
"type": "string"
},
"refresh_id": {
"description": "Refresh task UUID returned by pathrule_list_pending_refreshes or pathrule_get_refresh_brief.",
"format": "uuid",
"type": "string"
},
"status": {
"description": "Use 'rejected' from Remote MCP when the signal is stale or cannot be safely applied. 'applied' may be refused unless local verification is available.",
"enum": [
"applied",
"rejected"
],
"type": "string"
}
},
"required": [
"refresh_id",
"status"
],
"type": "object"
},
"name": "pathrule_resolve_refresh",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"refresh_id": {
"description": "The refresh task that was resolved.",
"type": "string"
},
"resolved_at": {
"description": "Resolution timestamp in ISO 8601.",
"type": "string"
},
"status": {
"description": "Final status recorded for the task.",
"type": "string"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Fetch the active Pathrule bootstrap brief and execute it. Call this ONCE when the user asks to set up / bootstrap / initialize Pathrule for a project (e.g. 'Set up Pathrule for this project', 'Bootstrap Pathrule'). The response `body` is a prompt you must follow immediately — it tells you how to scan the project, propose memories/rules/skills, and write the approved items via pathrule_write_memory / _rule / _skill. Do NOT call this mid-task, for already-populated workspaces, or when the user just wants context — use pathrule_get_context for routine context lookups. If no workspace exists yet, call pathrule_list_organizations + pathrule_create_workspace first.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"locale": {
"description": "Bootstrap brief language code. Defaults to 'en'. Pass 'tr' for Turkish users.",
"maxLength": 8,
"minLength": 2,
"type": "string"
},
"workspace_id": {
"description": "Target workspace. Omit only if the user has not picked one yet — you should then call pathrule_create_workspace before continuing the bootstrap.",
"format": "uuid",
"type": "string"
}
},
"type": "object"
},
"name": "pathrule_setup",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "The bootstrap brief.",
"properties": {
"body": {
"description": "The bootstrap brief to execute, step by step.",
"type": "string"
},
"bootstrap_v2": {
"anyOf": [
{},
{
"type": "null"
}
],
"description": "Reserved for the next bootstrap format. Currently null."
},
"locale": {
"description": "Locale the brief was served in.",
"type": "string"
},
"source": {
"description": "Where the brief came from: cloud for the requested locale, fallback for the English default.",
"type": "string"
},
"version": {
"description": "Bootstrap prompt version.",
"type": "string"
},
"workspace_id": {
"description": "Workspace the brief was scoped to, or null when called before a workspace exists.",
"type": [
"string",
"null"
]
}
},
"required": [
"version",
"locale",
"body",
"source",
"workspace_id"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"local_runtime": {
"additionalProperties": true,
"description": "Present on tools that carry the local-runtime upgrade reminder.",
"properties": {
"cta": {
"description": "Upgrade line to surface to the user when local Pathrule (Studio or CLI) would serve them better than Remote MCP.",
"type": "string"
}
},
"required": [
"cta"
],
"type": "object"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Record a point-in-time inventory of the user's project under a workspace. Remote MCP cannot see the filesystem, so YOU (the AI) collect this inventory with your own Read/Glob/Grep tools before calling this. Persist it so future setup, bootstrap, drift detection, and onboarding flows have structured evidence to reason over. Required: workspace_id. Strongly recommended: project_name, file_count, file_tree (cap at ~5000 entries — summarise deeper paths), file_extensions_summary, top_level_dirs, sampled_contents for README, package.json / pyproject.toml / Cargo.toml, CLAUDE.md, AGENTS.md, main config files (truncate each to ~4KB). Optional: git_head / branch / git_log_summary if you can read them, ai_notes for free-form observations.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ai_notes": {
"description": "Your own observations about the project structure, conventions, and obvious workspace seeds.",
"maxLength": 8192,
"type": "string"
},
"branch": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"description": "Checked-out branch name at snapshot time."
},
"file_count": {
"description": "Total number of files inventoried, before any file_tree cap is applied.",
"minimum": 0,
"type": "integer"
},
"file_extensions_summary": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"description": "e.g. {\"ts\": 412, \"tsx\": 158, \"json\": 33}",
"type": "object"
},
"file_tree": {
"description": "Flat list of files/directories. Cap at 5000.",
"items": {
"additionalProperties": false,
"properties": {
"depth": {
"minimum": 0,
"type": "integer"
},
"path": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"size": {
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"file",
"dir"
],
"type": "string"
}
},
"required": [
"path",
"type"
],
"type": "object"
},
"maxItems": 5000,
"type": "array"
},
"git_head": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"description": "Commit SHA that HEAD pointed at when the snapshot was taken."
},
"git_log_summary": {
"description": "Free-form summary of recent git activity if available (e.g. 'last 50 commits hot paths: src/foo.ts, src/bar.ts; bug fixes in api/').",
"maxLength": 32768,
"type": "string"
},
"git_remote_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Origin remote URL of the repository, or null when it has none."
},
"metadata": {
"additionalProperties": {},
"description": "Free-form additional structured data.",
"type": "object"
},
"project_name": {
"description": "Display name of the project, usually the repository or folder name.",
"maxLength": 255,
"type": "string"
},
"root_path": {
"description": "Absolute root path if the AI is running on the user's machine; otherwise omit.",
"maxLength": 1024,
"type": "string"
},
"sampled_contents": {
"description": "Truncated contents of up to 50 important files (README, manifest files, CLAUDE.md/AGENTS.md, primary configs). Each content field capped at ~4096 bytes.",
"items": {
"additionalProperties": false,
"properties": {
"bytes": {
"minimum": 0,
"type": "integer"
},
"content": {
"maxLength": 8192,
"type": "string"
},
"path": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
}
},
"required": [
"path",
"content"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"source": {
"description": "Which Pathrule surface produced this snapshot. Defaults to 'mcp-remote'.",
"enum": [
"mcp-remote",
"mcp-local",
"cli",
"desktop",
"other"
],
"type": "string"
},
"top_level_dirs": {
"description": "Immediate child directories of the project root with their sizes, so future flows can see the shape of the tree without the full file list.",
"items": {
"additionalProperties": false,
"properties": {
"file_count": {
"minimum": 0,
"type": "integer"
},
"name": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"total_size_bytes": {
"description": "Combined size in bytes of the inventoried files.",
"minimum": 0,
"type": "integer"
},
"workspace_id": {
"description": "Workspace UUID this snapshot belongs to.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id"
],
"type": "object"
},
"name": "pathrule_take_snapshot",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"additionalProperties": true,
"description": "What was stored, including the counts after server-side trimming.",
"properties": {
"created_at": {
"description": "Creation timestamp in ISO 8601.",
"type": "string"
},
"file_count": {
"description": "Recorded file count, or null.",
"type": [
"number",
"null"
]
},
"file_tree_entries_recorded": {
"description": "How many file-tree entries were stored.",
"type": "number"
},
"project_name": {
"description": "Recorded project name, or null.",
"type": [
"string",
"null"
]
},
"sampled_files_recorded": {
"description": "How many sampled file bodies were actually stored after server-side trimming.",
"type": "number"
},
"snapshot_id": {
"description": "UUID of the stored snapshot. Pass it to pathrule_read_snapshot.",
"type": "string"
},
"source": {
"description": "Pathrule surface that produced it.",
"type": "string"
},
"workspace_id": {
"description": "Workspace the snapshot belongs to.",
"type": "string"
}
},
"required": [
"snapshot_id",
"workspace_id",
"source",
"project_name",
"file_count",
"created_at",
"sampled_files_recorded",
"file_tree_entries_recorded"
],
"type": "object"
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Update a memory's content or title, optionally moving it. Uses optimistic concurrency via expected_version_id. Cloud-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allow_duplicate": {
"description": "Set true only when intentionally allowing another memory with the same title.",
"type": "boolean"
},
"content": {
"description": "Replacement memory body in clear project-language prose.",
"minLength": 1,
"type": "string"
},
"expected_version_id": {
"description": "Optional optimistic-concurrency token from the existing record. Pass it when available to avoid overwriting a newer edit.",
"format": "uuid",
"type": "string"
},
"memory_id": {
"description": "Memory UUID returned by pathrule_get_context, pathrule_goto, or pathrule_read_memory.",
"format": "uuid",
"type": "string"
},
"move_to_path": {
"description": "Optional workspace-relative destination path such as /packages/app. Missing nodes are created when allowed by the backend.",
"type": "string"
},
"related_paths": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional list of workspace-relative paths this memory is also relevant to. null = unchanged. Pass [] to clear all manual links. Max 32 entries."
},
"title": {
"description": "Optional replacement memory title.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"memory_id",
"content"
],
"type": "object"
},
"name": "pathrule_update_memory",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Updated memory: id, version_id, and the title it now carries."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"related_to_check": {
"description": "Up to 3 items that may need the same change (companions, links, near duplicates), from a cached knowledge map.",
"items": {},
"type": "array"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Update a rule's fields and/or path. Optimistic concurrency via expected_version_id. Cloud-only.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allow_duplicate": {
"description": "Set true only when intentionally allowing another rule with the same name.",
"type": "boolean"
},
"expected_version_id": {
"description": "Optional optimistic-concurrency token from the existing record. Pass it when available to avoid overwriting a newer edit.",
"format": "uuid",
"type": "string"
},
"move_to_path": {
"description": "Optional workspace-relative destination path such as /packages/app. Missing nodes are created when allowed by the backend.",
"type": "string"
},
"patch": {
"additionalProperties": false,
"description": "Fields to change. Omitted fields are left as they are, so send only what actually differs.",
"properties": {
"content": {
"description": "Replacement rule body.",
"minLength": 1,
"type": "string"
},
"name": {
"description": "Replacement rule name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"priority": {
"description": "Updated priority. Use high only when violating the rule causes real regressions.",
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"scope_type": {
"description": "Updated rule scope: project, folder, or file_type.",
"enum": [
"folder",
"file_type",
"project"
],
"type": "string"
}
},
"type": "object"
},
"rule_id": {
"description": "Rule UUID returned by pathrule_get_context, pathrule_goto, or pathrule_read_rule.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"rule_id",
"patch"
],
"type": "object"
},
"name": "pathrule_update_rule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Updated rule: id, version_id, and the name it now carries."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"related_to_check": {
"description": "Up to 3 items that may need the same change (companions, links, near duplicates), from a cached knowledge map.",
"items": {},
"type": "array"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Partially update an existing Pathrule skill record. Use pathrule_update_skill only when you already have a skill_id and want to change metadata, SKILL.md content, source/github_url, tags, or move the skill to another workspace path; use pathrule_write_skill to create a new skill, pathrule_read_skill to inspect the current body first, and pathrule_delete_skill to remove one. Requires an authenticated connector token with pathrule:write and an active workspace subscription. Side effects: writes the cloud skill record, may replace fields present in patch, may move the skill when move_to_path is set, and may fail on version conflict; it never installs files into .codex/skills, .claude/skills, or editor folders.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"expected_version_id": {
"description": "Optional version UUID from the current skill. Pass it after pathrule_read_skill to prevent overwriting someone else's newer edit; a stale value makes the update fail instead of silently replacing data.",
"format": "uuid",
"type": "string"
},
"move_to_path": {
"description": "Optional workspace-relative path to move the skill attachment, such as / or /packages/app. When provided, Pathrule moves the skill to that node and may create missing nodes; omit it to keep the current path.",
"type": "string"
},
"patch": {
"additionalProperties": false,
"description": "Partial update object. Include only fields that should change; omitted fields keep their current values. At least one field should be present. Replacing content overwrites the stored approved SKILL.md body.",
"properties": {
"content": {
"description": "Replacement full SKILL.md content including frontmatter and markdown.",
"minLength": 1,
"type": "string"
},
"description": {
"description": "Replacement usage summary. Use null to clear it.",
"type": [
"string",
"null"
]
},
"github_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Updated canonical GitHub URL for github_ref skills, or null to clear it."
},
"name": {
"description": "Replacement skill name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"source": {
"description": "Updated source type. Use github_ref only with a valid github_url.",
"enum": [
"manual",
"template",
"github_ref"
],
"type": "string"
},
"tags": {
"description": "Replacement discovery tag list.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"skill_id": {
"description": "Skill UUID returned by pathrule_get_context, pathrule_goto, or pathrule_read_skill.",
"format": "uuid",
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"skill_id",
"patch"
],
"type": "object"
},
"name": "pathrule_update_skill",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Updated skill: id, version_id, and the name it now carries."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"related_to_check": {
"description": "Up to 3 items that may need the same change (companions, links, near duplicates), from a cached knowledge map.",
"items": {},
"type": "array"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Create a new memory at a workspace path. Missing nodes auto-create. Blocks duplicate titles unless allow_duplicate is set. Cloud-only: never writes to the user's local filesystem. For automatic CLAUDE.md/AGENTS.md sync and on-disk hook injection alongside the write, install Pathrule Studio or CLI.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allow_duplicate": {
"description": "Set true only when a second memory with the same title on this node is intentional. Leave unset so near-duplicates are rejected.",
"type": "boolean"
},
"content": {
"description": "The memory body: the decision, convention, or bug pattern worth remembering, and why it matters.",
"minLength": 1,
"type": "string"
},
"node_path": {
"description": "Workspace-relative path, e.g. /apps/api.",
"minLength": 1,
"type": "string"
},
"related_paths": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional list of workspace-relative paths this memory is also relevant to. null = no links. Max 32 entries."
},
"source": {
"description": "Who authored the memory: claude when an agent wrote it, manual when the user dictated it. Defaults to claude.",
"enum": [
"claude",
"manual"
],
"type": "string"
},
"title": {
"description": "Short specific title. It is the duplicate key for this node, so make it the thing being remembered, not a category.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"node_path",
"title",
"content"
],
"type": "object"
},
"name": "pathrule_write_memory",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Created memory: id, title, node_id, node_path, version_id."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
},
"warnings": {
"description": "Non-fatal notices, for example a near-duplicate title that was allowed through.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Create a new rule at a workspace path. Missing nodes auto-create. Use scope_type/priority honestly: high only when a violation causes a real bug or regression. Cloud-only — Pathrule Studio/CLI also renders the rule into the user's CLAUDE.md/AGENTS.md and editor companion files automatically.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allow_duplicate": {
"description": "Set true only when intentionally allowing another rule with the same name.",
"type": "boolean"
},
"content": {
"description": "Rule body: the instruction agents must follow.",
"minLength": 1,
"type": "string"
},
"name": {
"description": "Short human-readable rule name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"node_path": {
"description": "Workspace-relative path where the rule applies, e.g. / or /packages/app.",
"minLength": 1,
"type": "string"
},
"priority": {
"description": "Use high only for rules whose violation causes bugs, security issues, or real regressions.",
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"scope_type": {
"description": "Use project for global rules, folder for path-specific rules, or file_type when the rule targets a class of files.",
"enum": [
"folder",
"file_type",
"project"
],
"type": "string"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"node_path",
"name",
"content",
"scope_type",
"priority"
],
"type": "object"
},
"name": "pathrule_write_rule",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Created rule: id, name, node_id, node_path, version_id."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Create a new skill at a workspace path. Content is the full SKILL.md body (frontmatter + markdown). For github_ref skills set source='github_ref' and github_url. Cloud-only: does NOT materialize the skill into .codex/skills, .claude/skills, .cursor/skills, etc. — Pathrule Studio or CLI is required for on-disk skill materialization.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"content": {
"description": "Full SKILL.md content including frontmatter and markdown.",
"minLength": 1,
"type": "string"
},
"description": {
"description": "Short summary of when agents should use this skill. Use null only if unknown.",
"type": [
"string",
"null"
]
},
"github_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Canonical GitHub URL for github_ref skills; null or omit for manual/template skills."
},
"name": {
"description": "Skill name, usually kebab-case.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"node_path": {
"description": "Workspace-relative path where the skill should be offered, e.g. / or /packages/app.",
"minLength": 1,
"type": "string"
},
"source": {
"description": "Skill source type. Use github_ref only when github_url points to the canonical skill source.",
"enum": [
"manual",
"template",
"github_ref"
],
"type": "string"
},
"tags": {
"description": "Optional discovery tags such as frontend, database, or release.",
"items": {
"type": "string"
},
"type": "array"
},
"workspace_id": {
"description": "Workspace UUID from pathrule_list_workspaces.",
"format": "uuid",
"type": "string"
}
},
"required": [
"workspace_id",
"node_path",
"name",
"description",
"content"
],
"type": "object"
},
"name": "pathrule_write_skill",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"data": {
"description": "Created skill: id, name, node_id, node_path, version_id."
},
"error": {
"additionalProperties": true,
"description": "Present only when ok is false.",
"properties": {
"code": {
"description": "Stable machine-readable failure code, for example insufficient_scope, workspace_id_required, rate_limited, not_found, or upstream_error. Branch on this, not on message text.",
"type": "string"
},
"detail": {
"description": "Optional structured context for the failure, for example { missing_scopes: [...] } on insufficient_scope."
},
"message": {
"description": "Human-readable explanation of the failure.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"human_message": {
"description": "One-line summary of the result, safe to relay to the user verbatim.",
"type": "string"
},
"ok": {
"description": "true when the call succeeded. false when it did not, in which case `error` carries the reason and the success fields are absent.",
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:89690a9e5bf74d50c32c5f42032b6958219490ed20a34640b0eae793cc336139 | sha256sum