Ricursor is an MCP server published by com.ricursor, hosted at api.ricursor.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including ricursor_action_check, ricursor_action_consume, ricursor_action_group_check, ricursor_action_group_consume, ricursor_correct.
Long-term, rotatable project memory and pre-write checks for AI coding agents.
1 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Metadata-only decision for a JS/TS write or delete. Returns allow or block (with reasons to fix) plus a one-use receipt. Never send source.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["write","delete"] |
| path * | string | |
| project * | string | |
| metadata | object | |
| action_id * | string | Unique per proposed action, 8-80 characters. |
| result_hash | string |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| dependencies | array |
| baseline_hash * | any |
| expected_version | integer |
{
"name": "ricursor_action_check",
"title": "Propose action",
"description": "Metadata-only decision for a JS/TS write or delete. Returns allow or block (with reasons to fix) plus a one-use receipt. Never send source.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"project",
"action_id",
"path",
"baseline_hash"
],
"properties": {
"kind": {
"enum": [
"write",
"delete"
],
"type": "string"
},
"path": {
"type": "string"
},
"project": {
"type": "string"
},
"metadata": {
"type": "object"
},
"action_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"result_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"dependencies": {
"type": "array"
},
"baseline_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"expected_version": {
"type": "integer",
"minimum": 0
}
}
},
"annotations": {
"openWorldHint": false
}
}Atomically consumes a receipt immediately before the broker executes. Fails if anything changed.
| Parameter | Type | Description |
|---|---|---|
| receipt * | string | |
| action_id * | string | Unique per proposed action, 8-80 characters. |
| result_hash * | any | |
| baseline_hash * | any |
{
"name": "ricursor_action_consume",
"title": "Consume receipt",
"description": "Atomically consumes a receipt immediately before the broker executes. Fails if anything changed.",
"inputSchema": {
"type": "object",
"required": [
"action_id",
"receipt",
"baseline_hash",
"result_hash"
],
"properties": {
"receipt": {
"type": "string"
},
"action_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"result_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"baseline_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"openWorldHint": false
}
}Metadata-only decision for up to 20 related JS/TS writes/deletes judged on their combined end state (moves, renames).
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| project * | string | |
| group_id * | string | Unique per proposed action, 8-80 characters. |
{
"name": "ricursor_action_group_check",
"title": "Propose related changes",
"description": "Metadata-only decision for up to 20 related JS/TS writes/deletes judged on their combined end state (moves, renames).",
"inputSchema": {
"type": "object",
"required": [
"project",
"group_id",
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 20,
"minItems": 1
},
"project": {
"type": "string"
},
"group_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
}
}
},
"annotations": {
"openWorldHint": false
}
}All-or-nothing consumption before the broker writes the group.
| Parameter | Type | Description |
|---|---|---|
| receipt * | string | |
| group_id * | string | Unique per proposed action, 8-80 characters. |
{
"name": "ricursor_action_group_consume",
"title": "Consume group receipt",
"description": "All-or-nothing consumption before the broker writes the group.",
"inputSchema": {
"type": "object",
"required": [
"group_id",
"receipt"
],
"properties": {
"receipt": {
"type": "string"
},
"group_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
}
},
"additionalProperties": false
},
"annotations": {
"openWorldHint": false
}
}After Ricursor blocks a check, save the one-sentence lesson so every agent on this project gets it. Only accepted for your own blocked action from the last 24 hours.
| Parameter | Type | Description |
|---|---|---|
| rule * | string | |
| project * | string | Project name inside the workspace. |
| action_id * | string | action_id or group_id of the blocked check. |
{
"name": "ricursor_correct",
"title": "Save verified correction",
"description": "After Ricursor blocks a check, save the one-sentence lesson so every agent on this project gets it. Only accepted for your own blocked action from the last 24 hours.",
"inputSchema": {
"type": "object",
"required": [
"project",
"action_id",
"rule"
],
"properties": {
"rule": {
"type": "string",
"maxLength": 500,
"minLength": 8
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"action_id": {
"type": "string",
"description": "action_id or group_id of the blocked check."
}
},
"additionalProperties": false
},
"annotations": {
"openWorldHint": false
}
}Read scoped metadata and rule versions before switching models. Observe only.
| Parameter | Type | Description |
|---|---|---|
| project * | string | Project name inside the workspace. |
{
"name": "ricursor_ledger",
"title": "Read model alignment",
"description": "Read scoped metadata and rule versions before switching models. Observe only.",
"inputSchema": {
"type": "object",
"required": [
"project"
],
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true
}
}Save structured task IDs and versioned rule decisions; never include prompts or source.
| Parameter | Type | Description |
|---|---|---|
| state * | object | |
| project * | string | Project name inside the workspace. |
| task_id * | string | |
| expected_version * | integer |
{
"name": "ricursor_handoff",
"title": "Save model handoff",
"description": "Save structured task IDs and versioned rule decisions; never include prompts or source.",
"inputSchema": {
"type": "object",
"required": [
"project",
"task_id",
"expected_version",
"state"
],
"properties": {
"state": {
"type": "object",
"required": [
"completed",
"pending",
"decisions"
],
"properties": {
"pending": {
"type": "array",
"items": {
"type": "string"
}
},
"completed": {
"type": "array",
"items": {
"type": "string"
}
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"required": [
"constraint_id",
"version",
"status"
],
"properties": {
"status": {
"enum": [
"accepted",
"conflict"
],
"type": "string"
},
"version": {
"type": "integer",
"minimum": 1
},
"constraint_id": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"task_id": {
"type": "string"
},
"expected_version": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"openWorldHint": false
}
}Sync locally extracted JS/TS structural metadata only; never transmit source.
| Parameter | Type | Description |
|---|---|---|
| files * | array | |
| project * | string | Project name inside the workspace. |
{
"name": "ricursor_snapshot",
"title": "Sync repository",
"description": "Sync locally extracted JS/TS structural metadata only; never transmit source.",
"inputSchema": {
"type": "object",
"required": [
"project",
"files"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"hash",
"metadata",
"expected_version"
],
"properties": {
"hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"path": {
"type": "string"
},
"metadata": {
"anyOf": [
{
"type": "object",
"required": [
"exports",
"imports"
],
"properties": {
"exports": {
"type": "array",
"items": {
"type": "string"
}
},
"imports": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"names"
],
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"expected_version": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
}
},
"additionalProperties": false
},
"annotations": {
"openWorldHint": false
}
}Stop on block or errors. Checks tracked versions, exports and accepted import boundaries; never writes code.
| Parameter | Type | Description |
|---|---|---|
| hash * | string | |
| path * | string | |
| project * | string | Project name inside the workspace. |
| metadata * | object | |
| dependencies * | array | |
| expected_version * | integer |
{
"name": "ricursor_check",
"title": "Check planned write",
"description": "Stop on block or errors. Checks tracked versions, exports and accepted import boundaries; never writes code.",
"inputSchema": {
"type": "object",
"required": [
"project",
"path",
"hash",
"metadata",
"expected_version",
"dependencies"
],
"properties": {
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"path": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"metadata": {
"type": "object",
"required": [
"exports",
"imports"
],
"properties": {
"exports": {
"type": "array",
"items": {
"type": "string"
}
},
"imports": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"names"
],
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"dependencies": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"version"
],
"properties": {
"path": {
"type": "string"
},
"version": {
"type": "integer",
"minimum": 1
}
}
},
"maxItems": 100
},
"expected_version": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}The workspace this key can reach.
No parameters.
{
"name": "ricursor_workspaces",
"title": "List workspaces",
"description": "The workspace this key can reach.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true
}
}The verified corrections and recent file changes an agent must respect before it writes code.
| Parameter | Type | Description |
|---|---|---|
| task | string | Task to retrieve relevant rules for. |
| limit | integer | |
| since | string | Previous cursor for this same key, project and task; returns changed rules and removed IDs. |
| project | string | Project name inside the workspace. |
| workspace | string | Ignored: the key already selects its workspace. |
{
"name": "ricursor_context",
"title": "Serve context",
"description": "The verified corrections and recent file changes an agent must respect before it writes code.",
"inputSchema": {
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "Task to retrieve relevant rules for."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"since": {
"type": "string",
"description": "Previous cursor for this same key, project and task; returns changed rules and removed IDs."
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"workspace": {
"type": "string",
"description": "Ignored: the key already selects its workspace."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
}
}Record what an agent spent (usage) and what it changed (state).
| Parameter | Type | Description |
|---|---|---|
| state | object | |
| usage | object | |
| project | string | Project name inside the workspace. |
| workspace | string | Ignored: the key already selects its workspace. |
| request_id * | string | Unique ID per logical report; reuse unchanged when retrying. |
{
"name": "ricursor_report",
"title": "Report activity",
"description": "Record what an agent spent (usage) and what it changed (state).",
"inputSchema": {
"type": "object",
"required": [
"request_id"
],
"properties": {
"state": {
"type": "object",
"required": [
"kind",
"path",
"detail"
],
"properties": {
"kind": {
"enum": [
"file_change",
"delta",
"alert"
],
"type": "string"
},
"path": {
"type": "string"
},
"detail": {
"enum": [
"file_added",
"file_updated",
"file_deleted",
"exports_changed",
"imports_changed",
"stale_baseline",
"policy_conflict"
],
"type": "string"
}
}
},
"usage": {
"type": "object",
"required": [
"model",
"day",
"baseline_tokens",
"served_tokens"
],
"properties": {
"day": {
"type": "string",
"description": "YYYY-MM-DD"
},
"model": {
"type": "string"
},
"served_tokens": {
"type": "integer"
},
"baseline_tokens": {
"type": "integer"
}
}
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"workspace": {
"type": "string",
"description": "Ignored: the key already selects its workspace."
},
"request_id": {
"type": "string",
"description": "Unique ID per logical report; reuse unchanged when retrying."
}
}
},
"annotations": {
"openWorldHint": false
}
}Sync modules with ricursor_snapshot. Call ricursor_context and ricursor_check before each write; stop on block or errors. After a block, save the lesson with ricursor_correct. Report afterwards. Checks cover tracked imports and accepted boundaries only.
Names, descriptions and schemas were written by the server and are shown as data.