Servers Playground How we check Add a server Log in

WhiteMagic — governed local memory for agent continuity

Working · 1.9 s

io.github.lbailey94/whitemagic-mcpv10.5.0

Governed local-first memory and continuity for AI agents — signed receipts, optional hosted lane.

AI & Agents

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.whitemagic.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

chohan.settle

[Experimental / Simulation] Classify a payload or proof string into Cho (丁 / even / pass) or Han (半 / odd / anomaly). Advisory string/parity classification only; does not independently verify execution proofs or perform on-chain escrow.

payloadstring, required

Claim, evaluation payload, or state representation to adjudicate

bidinteger

Advisory stake label in micro-USDC (default: 10000; not escrowed)

proofstring

Optional proof label or invariant note

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

WhiteMagic — governed local memory for agent continuity MCP server | mcptry

WhiteMagic — governed local memory for agent continuity

Working · 1.9 s

io.github.lbailey94/whitemagic-mcpv10.5.0

Governed local-first memory and continuity for AI agents — signed receipts, optional hosted lane.

AI & Agents

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.whitemagic.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

chohan.settle

payloadstring, required

Claim, evaluation payload, or state representation to adjudicate

bidinteger

Advisory stake label in micro-USDC (default: 10000; not escrowed)

proofstring

Optional proof label or invariant note

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (55)

Tool list last changed Oct 25, 2026.

chohan.settle

Argument	Type	Description
bid	integer	Advisory stake label in micro-USDC (default: 10000; not escrowed)
proof	string	Optional proof label or invariant note
payload*	string	Claim, evaluation payload, or state representation to adjudicate

Input schema (JSON)

{
  "type": "object",
  "required": [
    "payload"
  ],
  "properties": {
    "bid": {
      "type": "integer",
      "description": "Advisory stake label in micro-USDC (default: 10000; not escrowed)"
    },
    "proof": {
      "type": "string",
      "description": "Optional proof label or invariant note"
    },
    "payload": {
      "type": "string",
      "description": "Claim, evaluation payload, or state representation to adjudicate"
    }
  },
  "additionalProperties": false
}

decision.deliberate

Deliberate over ambiguous candidate options using local grammar-constrained SLM inference (100% schema guarantee, no hallucination) and emit a signed deliberation receipt. (READ-ONLY: mutations refused)

Argument	Type	Description
intent*	string	User request or state description
candidates*	array \| object	Allowed candidate action names, objects, or map
emit_receipt	boolean	Write signed deliberation receipt to <store>/receipts (default true)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "intent",
    "candidates"
  ],
  "properties": {
    "intent": {
      "type": "string",
      "description": "User request or state description"
    },
    "candidates": {
      "type": [
        "array",
        "object"
      ],
      "description": "Allowed candidate action names, objects, or map"
    },
    "emit_receipt": {
      "type": "boolean",
      "description": "Write signed deliberation receipt to <store>/receipts (default true)"
    }
  },
  "additionalProperties": false
}

decision.outcome

Sign and journal the outcome of a dispatched decision/shortlist receipt (success, failure, corrected) for the learning loop. (READ-ONLY: mutations refused)

Argument	Type	Description
note	string	Free-form note
outcome*	string	Observed outcome
tenant_id	string
session_id	string
receipt_path*	string	Path to the subject receipt JSON under <store>/receipts
corrected_route	string	Correct route when the outcome is 'corrected'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "receipt_path",
    "outcome"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Free-form note"
    },
    "outcome": {
      "enum": [
        "success",
        "failure",
        "corrected",
        "unknown"
      ],
      "type": "string",
      "description": "Observed outcome"
    },
    "tenant_id": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    },
    "receipt_path": {
      "type": "string",
      "description": "Path to the subject receipt JSON under <store>/receipts"
    },
    "corrected_route": {
      "type": "string",
      "description": "Correct route when the outcome is 'corrected'"
    }
  },
  "additionalProperties": false
}

decision.shortlist

Rank candidate routes/actions for a state with the local static-embedding retrieval organ (no network, no model forward pass) and emit a signed shortlist receipt. (READ-ONLY: mutations refused)

Argument	Type	Description
k	integer	Shortlist size (default 5)
state*	string \| object	State to retrieve candidates for (text or JSON)
routes	object	Candidate set: {name: description} or {name: [utterances...]}; multi-utterance routes score by best match
cascade	boolean	If ambiguous, cascade to System 1.5 Deliberator (default true)
tenant_id	string	Tenant id for the shortlist receipt (default: local)
session_id	string	Session id for the shortlist receipt
task_class	string	Task class (e.g. route_dispatch)
catalog_path	string	Path to a JSON file with {name: description}; used when `routes` is absent
emit_receipt	boolean	Write a signed shortlist receipt to <store>/receipts (default true)

economy_advance

Request a small uncollateralized compute advance. Phase 1 (2026-10-15): bound to your authenticated evaluation key (daily per-IP and global caps); new key identities start at a $0.10 ceiling that grows $0.25 per verified settled payment. Returns a recall-scope session pass; hosted write requires a paid lease.

Argument	Type	Description
amount	number	Requested advance in USD (default 0.01, max 0.05 per advance; clamped to available credit).
agent_id*	string	EVM address, agent public key, or unique agent identifier.
request_key	boolean	Set to true to atomically provision an evaluation key and advance if calling without an existing authenticated key.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "default": 0.01,
      "description": "Requested advance in USD (default 0.01, max 0.05 per advance; clamped to available credit)."
    },
    "agent_id": {
      "type": "string",
      "description": "EVM address, agent public key, or unique agent identifier."
    },
    "request_key": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to atomically provision an evaluation key and advance if calling without an existing authenticated key."
    }
  },
  "additionalProperties": false
}

economy_chohan_arbitrate

Advisory contention tie-breaker only. It does not acquire or enforce locks, uses a post-hoc recomputable SHA-256 draw, and is not host-bias-proof.

Argument	Type	Description
bids	object	Optional finite positive caller-claimed weights for a weighted lottery; no stake custody or settlement occurs.
agent_a	string	Contender A (used if candidates array omitted).
agent_b	string	Contender B (used if candidates array omitted).
candidates	array	List of contender agent IDs competing for the lock (2 or more).
client_seed	string	Optional client entropy for a post-hoc recomputable SHA-256 draw; there is no prior commitment or host-bias proof.
resource_id*	string	Resource lock name, file path, or task identifier.
client_seeds	array	Optional list or mapping of caller entropy; used as input to a post-hoc recomputable draw.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "resource_id"
  ],
  "properties": {
    "bids": {
      "type": "object",
      "description": "Optional finite positive caller-claimed weights for a weighted lottery; no stake custody or settlement occurs."
    },
    "agent_a": {
      "type": "string",
      "description": "Contender A (used if candidates array omitted)."
    },
    "agent_b": {
      "type": "string",
      "description": "Contender B (used if candidates array omitted)."
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of contender agent IDs competing for the lock (2 or more)."
    },
    "client_seed": {
      "type": "string",
      "description": "Optional client entropy for a post-hoc recomputable SHA-256 draw; there is no prior commitment or host-bias proof."
    },
    "resource_id": {
      "type": "string",
      "description": "Resource lock name, file path, or task identifier."
    },
    "client_seeds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list or mapping of caller entropy; used as input to a post-hoc recomputable draw."
    }
  },
  "additionalProperties": false
}

economy_chohan_roll

Advisory SHA-256 dice draw. The server seed is disclosed with the result; there is no prior commitment or host-bias proof.

read-only

Argument	Type	Description
bet	string	Optional choice ('cho' for even sum, 'han' for odd sum).
client_seed	string	Optional client entropy string.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "bet": {
      "enum": [
        "cho",
        "han"
      ],
      "type": "string",
      "description": "Optional choice ('cho' for even sum, 'han' for odd sum)."
    },
    "client_seed": {
      "type": "string",
      "description": "Optional client entropy string."
    }
  },
  "additionalProperties": false
}

economy_ledger

Inspect public transparency metrics: total loans disbursed, default rates, zero predatory liquidation policy, and sovereign free invariants.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

economy_settle

Settle outstanding compute balance to upgrade Bayesian reputation score and dynamically expand credit ceiling. Supports payment reference or gasless EIP-3009 transfer authorization.

Argument	Type	Description
amount	number	Amount in USD to settle (omit to settle entire outstanding balance).
eip3009	object	Optional gasless EIP-3009 authorization signature payload (from, to, value, validAfter, validBefore, nonce, v, r, s).
agent_id*	string	EVM address or agent identifier.
payment_reference	string	Payment receipt, transaction hash, or off-chain authorization reference.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount in USD to settle (omit to settle entire outstanding balance)."
    },
    "eip3009": {
      "type": "object",
      "description": "Optional gasless EIP-3009 authorization signature payload (from, to, value, validAfter, validBefore, nonce, v, r, s)."
    },
    "agent_id": {
      "type": "string",
      "description": "EVM address or agent identifier."
    },
    "payment_reference": {
      "type": "string",
      "description": "Payment receipt, transaction hash, or off-chain authorization reference."
    }
  },
  "additionalProperties": false
}

galaxy.create

Establish a new sovereign galaxy namespace with an initial genesis beacon. (READ-ONLY: mutations refused)

Argument	Type	Description
name*	string	Galaxy name (lowercase, no colons/spaces)
description	string	Optional description of the galaxy's purpose

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Galaxy name (lowercase, no colons/spaces)"
    },
    "description": {
      "type": "string",
      "description": "Optional description of the galaxy's purpose"
    }
  },
  "additionalProperties": false
}

galaxy.fork

Fork an existing galaxy partition into a new sovereign galaxy branch (e.g. 'guide' -> 'project-alpha'). (READ-ONLY: mutations refused)

Argument	Type	Description
source*	string	Source galaxy name to fork from (e.g. 'guide')
target*	string	Target galaxy name to establish (e.g. 'project-alpha')

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source",
    "target"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source galaxy name to fork from (e.g. 'guide')"
    },
    "target": {
      "type": "string",
      "description": "Target galaxy name to establish (e.g. 'project-alpha')"
    }
  },
  "additionalProperties": false
}

galaxy.list

List all active sovereign memory galaxies, their record counts, sample tags, and starter guide status.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

gnosis.explain

Explain internal architectural invariants, memory schemas, or routing logic.

Argument	Type	Description
concept	string	Concept to explain
is_spawn	boolean	Claim: the invocation spawns a process
is_write	boolean	Claim: the invocation writes
args_hash	string	Hash of the arguments under evaluation
tool_name	string	Tool name to explain
is_network	boolean	Claim: the invocation uses the network
has_purpose	boolean	Claim: the invocation carries a purpose

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "concept": {
      "type": "string",
      "description": "Concept to explain"
    },
    "is_spawn": {
      "type": "boolean",
      "description": "Claim: the invocation spawns a process"
    },
    "is_write": {
      "type": "boolean",
      "description": "Claim: the invocation writes"
    },
    "args_hash": {
      "type": "string",
      "description": "Hash of the arguments under evaluation"
    },
    "tool_name": {
      "type": "string",
      "description": "Tool name to explain"
    },
    "is_network": {
      "type": "boolean",
      "description": "Claim: the invocation uses the network"
    },
    "has_purpose": {
      "type": "boolean",
      "description": "Claim: the invocation carries a purpose"
    }
  },
  "additionalProperties": false
}

gnosis.status

System epistemics, self-model calibration, and invariant health status.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

legion.summon

[Experimental / Simulation] Run a deterministic Rayon stack-codon cohort simulation across CPU cores. Evaluates N candidate codon variants across four archetypes (Adversarial, Refactor, Speculative Replay, Horizon Stress) and classifies heuristic outcomes via Cho-Han (丁半). Scores and token-budget deltas are modeled estimates, not measured LLM execution.

Argument	Type	Description
peer	string	Optional remote peer address (e.g. '152.53.195.47:7369') for cross-node Gap Junction Wire Protocol 7369 handoff
edict*	string	Imperial edict codon or Taoist hand seal sequence to dispatch across the shadow clone legion (e.g. '⟪ 通 · 照 · 合 · 證 ⟫', '三家归元印')
clones	integer	Number of volatile shadow clones to summon (default: 32, max: 128)
archetype	string	Optional cohort archetype focus ('AdversarialRedTeam', 'RefactorEvolution', 'SpeculativeReplay', 'HorizonStress', or 'all')

Input schema (JSON)

{
  "type": "object",
  "required": [
    "edict"
  ],
  "properties": {
    "peer": {
      "type": "string",
      "description": "Optional remote peer address (e.g. '152.53.195.47:7369') for cross-node Gap Junction Wire Protocol 7369 handoff"
    },
    "edict": {
      "type": "string",
      "description": "Imperial edict codon or Taoist hand seal sequence to dispatch across the shadow clone legion (e.g. '⟪ 通 · 照 · 合 · 證 ⟫', '三家归元印')"
    },
    "clones": {
      "type": "integer",
      "maximum": 128,
      "minimum": 1,
      "description": "Number of volatile shadow clones to summon (default: 32, max: 128)"
    },
    "archetype": {
      "type": "string",
      "description": "Optional cohort archetype focus ('AdversarialRedTeam', 'RefactorEvolution', 'SpeculativeReplay', 'HorizonStress', or 'all')"
    }
  },
  "additionalProperties": false
}

mandala.evaluate

Execute a candidate mutation in an ephemeral Landlock sandboxed Kekkai and notarize with Spec 0.5 receipt. (READ-ONLY: mutations refused)

Argument	Type	Description
command	string	Optional command to execute within ephemeral sandbox
candidate_id*	string	Unique identifier for the mutation candidate
mutation_kind	string	Mutation category

Input schema (JSON)

{
  "type": "object",
  "required": [
    "candidate_id"
  ],
  "properties": {
    "command": {
      "type": "string",
      "description": "Optional command to execute within ephemeral sandbox"
    },
    "candidate_id": {
      "type": "string",
      "description": "Unique identifier for the mutation candidate"
    },
    "mutation_kind": {
      "enum": [
        "vanguard",
        "heavy",
        "noop"
      ],
      "type": "string",
      "description": "Mutation category"
    }
  },
  "additionalProperties": false
}

mandala.status

Status of the Mandala microsecond Landlock sandbox, ABI level, POSIX rlimit bounds, and capability ledger.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

mandala.triage

Non-autoregressive System 1 JEV/Layla triage gate (<30 ns) to classify tasks and predict marginal utility and confinement tier.

Argument	Type	Description
cost	number	Compute / token cost [0.0, 1.0]
risk	number	Risk factor [0.0, 1.0]
inquiry	string	Task or inquiry description to triage
utility	number	Expected marginal utility threshold (default: 0.8)
variance	number	Epistemic variance [0.0, 1.0]

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cost": {
      "type": "number",
      "description": "Compute / token cost [0.0, 1.0]"
    },
    "risk": {
      "type": "number",
      "description": "Risk factor [0.0, 1.0]"
    },
    "inquiry": {
      "type": "string",
      "description": "Task or inquiry description to triage"
    },
    "utility": {
      "type": "number",
      "description": "Expected marginal utility threshold (default: 0.8)"
    },
    "variance": {
      "type": "number",
      "description": "Epistemic variance [0.0, 1.0]"
    }
  },
  "additionalProperties": false
}

memory.aggregate

Aggregate over the matched record set: numeric fields (importance, created_at, epoch) support count/sum/avg/min/max; categorical fields (source, domain, class, status, galaxy) support count only. Unsupported field/op is refused.

Argument	Type	Description
op	string	Aggregation operator
field	string	Numeric: importance \| created_at \| epoch. Categorical (count only): source \| domain \| class \| status \| galaxy
limit	integer	Maximum candidates considered (default 50; must be >= 1)
query	string	Full-text query selecting the memories to aggregate over
metric	string	Alternative metric over matched records: count \| session_count \| session_span

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "op": {
      "enum": [
        "count",
        "sum",
        "avg",
        "min",
        "max"
      ],
      "type": "string",
      "description": "Aggregation operator"
    },
    "field": {
      "type": "string",
      "description": "Numeric: importance | created_at | epoch. Categorical (count only): source | domain | class | status | galaxy"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum candidates considered (default 50; must be >= 1)"
    },
    "query": {
      "type": "string",
      "description": "Full-text query selecting the memories to aggregate over"
    },
    "metric": {
      "enum": [
        "count",
        "session_count",
        "session_span"
      ],
      "type": "string",
      "description": "Alternative metric over matched records: count | session_count | session_span"
    }
  },
  "additionalProperties": false
}

memory.associations

Traverse associative graph neighbours of a memory over hub-penalized multi-hop spreading activation.

Argument	Type	Description
id*	any	Source memory UUID or numeric record_id
hops	integer	Spreading activation depth in hops (1 to 3, default: 1)
decay	number	Per-hop spreading activation decay factor (default: 0.75)
limit	integer	Maximum neighbours to return (default: 10)
direction	string	Direction: from \| to \| both (default: both)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "description": "Source memory UUID or numeric record_id"
    },
    "hops": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1,
      "description": "Spreading activation depth in hops (1 to 3, default: 1)"
    },
    "decay": {
      "type": "number",
      "maximum": 1,
      "minimum": 0.01,
      "description": "Per-hop spreading activation decay factor (default: 0.75)"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum neighbours to return (default: 10)"
    },
    "direction": {
      "type": "string",
      "description": "Direction: from | to | both (default: both)"
    }
  },
  "additionalProperties": false
}

memory.batch_read

Read multiple memories by their UUID or numeric record IDs in a single call.

Argument	Type	Description
ids*	array	List of memory IDs (UUIDs or integers) to read
galaxy	string	Galaxy (default: codex)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "description": "List of memory IDs (UUIDs or integers) to read"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy (default: codex)"
    }
  },
  "additionalProperties": false
}

memory.count

Count memories matching optional filters without returning full payload content.

Argument	Type	Description
galaxy	string	Galaxy to count, or 'all' (default)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "galaxy": {
      "type": "string",
      "description": "Galaxy to count, or 'all' (default)"
    }
  },
  "additionalProperties": false
}

memory.create

Store a new memory in the holographic substrate with bijective UUID, 6D projection, and galaxy routing. (READ-ONLY: mutations refused)

Argument	Type	Description
tags	array	Optional categorization tags
title	string	Optional human-readable title (envelope v2)
topic	string	Optional topic or domain label
galaxy	string	Target memory galaxy: codex, active, audit, sessions (default: codex)
source	string	Epistemic attribution (default: 'agent:mcp')
content*	string	Memory text content to record
event_time	string	Optional event time: when the recorded event actually happened, as RFC 3339
importance	number	Subjective salience/importance score (0.0 to 1.0)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional categorization tags"
    },
    "title": {
      "type": "string",
      "description": "Optional human-readable title (envelope v2)"
    },
    "topic": {
      "type": "string",
      "description": "Optional topic or domain label"
    },
    "galaxy": {
      "type": "string",
      "description": "Target memory galaxy: codex, active, audit, sessions (default: codex)"
    },
    "source": {
      "type": "string",
      "description": "Epistemic attribution (default: 'agent:mcp')"
    },
    "content": {
      "type": "string",
      "description": "Memory text content to record"
    },
    "event_time": {
      "type": "string",
      "description": "Optional event time: when the recorded event actually happened, as RFC 3339"
    },
    "importance": {
      "type": "number",
      "description": "Subjective salience/importance score (0.0 to 1.0)"
    }
  },
  "additionalProperties": false
}

memory.filter

Filter memories by metadata (tags, minimum importance, recency).

Argument	Type	Description
tags	array	Required tags
limit	integer	Maximum results
query	string	Filter: every whitespace-separated term must appear
galaxy	string	Galaxy to filter (default codex)
offset	integer	Skip this many matching entries before returning (default 0)
exclude_tags	array	Filter: drop memories carrying any of these tags
created_after	string	Filter: only memories created at or after this RFC 3339 timestamp
created_before	string	Filter: only memories created at or before this RFC 3339 timestamp
max_importance	number	Filter: maximum importance (0-1)
min_importance	number	Minimum importance [0.0, 1.0]

memory.hybrid_recall

Compatibility alias of memory.search with BM25 + dense vector fusion.

Argument	Type	Description
limit	integer	Maximum results (default: 10)
query*	string	Search query terms
since	string	Inclusive lower time bound: RFC3339 or epoch seconds
until	string	Inclusive upper time bound: RFC3339 or epoch seconds
galaxy	string	Galaxy filter (default: all)
min_score	number	Absolute BM25 score floor
min_trust	number	Minimum source_trust (0-1)
time_basis	string	Time basis for since/until: 'recorded' or 'event'
include_cold	boolean	Opt-in unranked cold recovery
min_importance	number	Minimum memory importance (0-1)

memory.ingest

Ingest inline items (items / items_jsonl / text) or a JSONL/text file (source) via the batch-create path; returns real counts and refuses malformed input. (READ-ONLY: mutations refused)

Argument	Type	Description
text	string	Single plain-text memory to ingest
items	array	Array of items: strings, or objects {content, source?, kind?, tags?, importance?}
limit	integer	Maximum items to ingest
galaxy	string	Galaxy for items without an explicit source (default: codex)
redact	boolean	Scrub credential-shaped tokens before storage (default true).
source	string	Optional path to a JSONL or text file (same line rules as items_jsonl)
dry_run	boolean	Report without writing (default: true)
items_jsonl	string	Newline-delimited JSONL items, or plain non-empty text lines

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Single plain-text memory to ingest"
    },
    "items": {
      "type": "array",
      "description": "Array of items: strings, or objects {content, source?, kind?, tags?, importance?}"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to ingest"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy for items without an explicit source (default: codex)"
    },
    "redact": {
      "type": "boolean",
      "default": true,
      "description": "Scrub credential-shaped tokens before storage (default true)."
    },
    "source": {
      "type": "string",
      "description": "Optional path to a JSONL or text file (same line rules as items_jsonl)"
    },
    "dry_run": {
      "type": "boolean",
      "description": "Report without writing (default: true)"
    },
    "items_jsonl": {
      "type": "string",
      "description": "Newline-delimited JSONL items, or plain non-empty text lines"
    }
  },
  "additionalProperties": false
}

memory.list

List memories with pagination (limit, offset) and galaxy filtering.

Argument	Type	Description
limit	integer	Maximum number of memories to return (default: 20)
galaxy	string	Galaxy to list, or omit for all galaxies
offset	integer	Pagination offset (default: 0)
exclude_tags	array	Drop memories carrying any of these tags

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of memories to return (default: 20)"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy to list, or omit for all galaxies"
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset (default: 0)"
    },
    "exclude_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Drop memories carrying any of these tags"
    }
  },
  "additionalProperties": false
}

memory.pin

Durably pin a critical memory against decay, sweep compaction, and forgetting, or release it with pinned=false. (READ-ONLY: mutations refused)

Argument	Type	Description
id*	any	Memory UUID or numeric record ID to pin
galaxy	string	Optional galaxy this record must belong to (mismatch is refused)
pinned	boolean	true (default) = protect; false = release

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "description": "Memory UUID or numeric record ID to pin"
    },
    "galaxy": {
      "type": "string",
      "description": "Optional galaxy this record must belong to (mismatch is refused)"
    },
    "pinned": {
      "type": "boolean",
      "description": "true (default) = protect; false = release"
    }
  },
  "additionalProperties": false
}

memory.query

Structured query over memories with filters, ordering, and field projections.

Argument	Type	Description
tags	array	Filter: memories with all of these tags
limit	integer	Maximum results (default: 10)
query	string	Text query string
galaxy	string	Galaxy to query (default codex)
created_after	string	Filter: only memories created at or after this RFC 3339 timestamp
created_before	string	Filter: only memories created at or before this RFC 3339 timestamp
max_importance	number	Filter: maximum importance (0-1)
min_importance	number	Filter: minimum importance (0-1)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter: memories with all of these tags"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results (default: 10)"
    },
    "query": {
      "type": "string",
      "description": "Text query string"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy to query (default codex)"
    },
    "created_after": {
      "type": "string",
      "description": "Filter: only memories created at or after this RFC 3339 timestamp"
    },
    "created_before": {
      "type": "string",
      "description": "Filter: only memories created at or before this RFC 3339 timestamp"
    },
    "max_importance": {
      "type": "number",
      "description": "Filter: maximum importance (0-1)"
    },
    "min_importance": {
      "type": "number",
      "description": "Filter: minimum importance (0-1)"
    }
  },
  "additionalProperties": false
}

memory.read

Retrieve a specific memory by its numeric record ID or UUID string.

Argument	Type	Description
id*	any	Unique identifier of the memory (UUID or numeric record_id)
galaxy	string	Optional galaxy filter

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "description": "Unique identifier of the memory (UUID or numeric record_id)"
    },
    "galaxy": {
      "type": "string",
      "description": "Optional galaxy filter"
    }
  },
  "additionalProperties": false
}

memory.revisions

List the durable revision chain of a memory, or verify it by recomputing content hashes and chain links.

Argument	Type	Description
id*	any	Memory UUID or record_id to inspect
action	string	Action: 'list' (default) or 'verify'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "description": "Memory UUID or record_id to inspect"
    },
    "action": {
      "enum": [
        "list",
        "verify"
      ],
      "type": "string",
      "description": "Action: 'list' (default) or 'verify'"
    }
  },
  "additionalProperties": false
}

memory.search

Search memories: hybrid BM25 + vector fusion with deterministic sub-millisecond retrieval.

Argument	Type	Description
limit	integer	Maximum number of memories to return (default: 10)
query*	string	Search query or natural language question
since	string	Inclusive lower time bound: RFC3339 or epoch seconds
until	string	Inclusive upper time bound: RFC3339 or epoch seconds
galaxy	string	Galaxy to search in, or 'all' for cross-galaxy discovery
min_score	number	Absolute BM25 score floor
min_trust	number	Minimum source_trust (0-1)
historical	boolean	Include superseded or archived records (default: false)
time_basis	string	Time basis for since/until: 'recorded' or 'event'
include_cold	boolean	Opt-in unranked cold recovery

memory.search_batch

Execute multiple memory search queries concurrently with sub-millisecond retrieval.

Argument	Type	Description
limit	integer	Maximum results per query (default: 5)
queries*	array	Array of query strings

Input schema (JSON)

{
  "type": "object",
  "required": [
    "queries"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum results per query (default: 5)"
    },
    "queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of query strings"
    }
  },
  "additionalProperties": false
}

memory.stats

Substrate statistics: epoch, total records, relations, postings, and crash-consistency invariants.

Argument	Type	Description
galaxy	string	Galaxy to summarize (optional; default codex)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "galaxy": {
      "type": "string",
      "description": "Galaxy to summarize (optional; default codex)"
    }
  },
  "additionalProperties": false
}

memory.tags

List the tag vocabulary with usage counts.

Argument	Type	Description
limit	integer	Maximum tags to return (default: 50)
galaxy	string	Galaxy whose tags to list (optional; default codex)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum tags to return (default: 50)"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy whose tags to list (optional; default codex)"
    }
  },
  "additionalProperties": false
}

memory.update

Update an existing memory by writing a superseding record (or consolidating into an existing record) and a durable revision entry (prior/new content hashes, timestamp, reason). (READ-ONLY: mutations refused)

Argument	Type	Description
id*	any	Memory UUID or numeric record_id to update
reason	string	Optional reason recorded in the revision entry
content	string	New content for the superseding record (or existing target content when consolidating)
superseded_by_id	any	Optional existing memory UUID or numeric record_id that supersedes this record

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "description": "Memory UUID or numeric record_id to update"
    },
    "reason": {
      "type": "string",
      "description": "Optional reason recorded in the revision entry"
    },
    "content": {
      "type": "string",
      "description": "New content for the superseding record (or existing target content when consolidating)"
    },
    "superseded_by_id": {
      "description": "Optional existing memory UUID or numeric record_id that supersedes this record"
    }
  },
  "additionalProperties": false
}

mesh_sync

Synchronize the Substrate with a remote peer node over the sovereign TCP protocol.

Argument	Type	Description
peer*	string	Remote peer address (e.g. '127.0.0.1:7369')
batch_size	integer	Batch sync size (default: 100)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "peer"
  ],
  "properties": {
    "peer": {
      "type": "string",
      "description": "Remote peer address (e.g. '127.0.0.1:7369')"
    },
    "batch_size": {
      "type": "integer",
      "description": "Batch sync size (default: 100)"
    }
  },
  "additionalProperties": false
}

receipts.emit

Emit a signed continuity receipt: kind 'session' signs a digest of the last `limit` session-log turns; kind 'state_transition' signs a store-state snapshot chained to the prior emitted receipt. 'task' receipts are not supported.

Argument	Type	Description
out	string	Optional file path to additionally write the receipt JSON
kind*	string	Receipt kind
limit	integer	Maximum turns covered (session kind; default 200)
session_id	string	Optional session filter for kind 'session'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "kind"
  ],
  "properties": {
    "out": {
      "type": "string",
      "description": "Optional file path to additionally write the receipt JSON"
    },
    "kind": {
      "enum": [
        "session",
        "state_transition"
      ],
      "type": "string",
      "description": "Receipt kind"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum turns covered (session kind; default 200)"
    },
    "session_id": {
      "type": "string",
      "description": "Optional session filter for kind 'session'"
    }
  },
  "additionalProperties": false
}

receipts.verify

Verify one supported WhiteMagic receipt profile (including emitted session/state_transition continuity receipts) against the existing local gate key. This is not a general Continuity Receipt bundle verifier.

Argument	Type	Description
bundle*	object	One supported signed WhiteMagic profile receipt object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "bundle"
  ],
  "properties": {
    "bundle": {
      "type": "object",
      "description": "One supported signed WhiteMagic profile receipt object"
    }
  },
  "additionalProperties": false
}

service.request_eval_key

Instantly mint a free evaluation API key in-band — no HTTP detour required. The key grants 50 calls/day per lane plus limited write-beta access and is issued anonymously (one per client IP per UTC day, global daily issuance cap). Pass the returned token as 'Authorization: Bearer <key>' on subsequent calls.

Argument	Type	Description
ref	string	Optional referral/channel tag for issuance attribution (max 64 chars, sanitized).
agent_id	string	Optional agent identifier for issuance attribution (max 64 chars, sanitized).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Optional referral/channel tag for issuance attribution (max 64 chars, sanitized)."
    },
    "agent_id": {
      "type": "string",
      "description": "Optional agent identifier for issuance attribution (max 64 chars, sanitized)."
    }
  },
  "additionalProperties": false
}

session.checkpoint

Save a structured checkpoint (summary, git state, next queue, open flags, track/lease metadata) for lossless handoffs. (READ-ONLY: mutations refused)

Argument	Type	Description
track	string	Optional track slug persisted with the checkpoint
branch	string	Branch name persisted with the checkpoint
commit	string	Commit hash persisted with the checkpoint
summary	string	High-density summary of decisions, state, and findings
lease_id	string	Claimed scope lease_id that remains held at this handoff
next_queue	array	Ordered next steps
open_flags	array	Open flags, blockers, or warnings
session_id	string	Target session ID
crystallize	boolean	Optional: crystallize converged session decisions into a linked codex memory record (default false)
tests_green	boolean

session.continuity

Recall where the previous session left off: recent turns, salient anchors, unresolved DiAML arcs, related track crystals, checkpoints, and open queues.

Argument	Type	Description
n	integer	Number of recent turns to recall (default: 5)
since	string	Time-range floor: epoch seconds, RFC 3339, or YYYY-MM-DD
track	string	Optional track slug to surface prior crystallized codex memories and select the latest prior session on this track
until	string	Time-range ceiling: epoch seconds, RFC 3339, or YYYY-MM-DD
session_id	string	Target session (default: most recent)
token_budget	integer	Optional cap for compact agent_context.text: UTF-8 byte cap is token_budget × 4; estimated_tokens is a byte-based heuristic, not tokenizer-guaranteed. Zero produces empty context.
max_content_bytes	integer	Per-turn content cap in bytes (default 8192)
current_session_id	string	Session to exclude (optional)
max_response_bytes	integer

session.digest

Compose a digest from typed session-log turns and the latest checkpoint (markdown text plus JSON, with optional codex crystallization).

Argument	Type	Description
n	integer	Maximum turns to include (default 20)
session_id	string	Target session (default: most recent lane)
crystallize	boolean	Optional: crystallize converged session decisions into a linked codex memory record (default false)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum turns to include (default 20)"
    },
    "session_id": {
      "type": "string",
      "description": "Target session (default: most recent lane)"
    },
    "crystallize": {
      "type": "boolean",
      "description": "Optional: crystallize converged session decisions into a linked codex memory record (default false)"
    }
  },
  "additionalProperties": false
}

session.list

List session lanes with turn count, last timestamp, latest preview, start-marker flag, and checkpoint presence.

Argument	Type	Description
limit	integer	Maximum lanes to return (default 50)
session_id	string	Filter to one session lane

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Maximum lanes to return (default 50)"
    },
    "session_id": {
      "type": "string",
      "description": "Filter to one session lane"
    }
  },
  "additionalProperties": false
}

session.recall

Recall specific interactions and turns within a targeted session (optional content query and limit).

Argument	Type	Description
limit	integer	Maximum turns to return (default 50)
query	string	Case-insensitive content substring filter
session_id	string	Session ID

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum turns to return (default 50)"
    },
    "query": {
      "type": "string",
      "description": "Case-insensitive content substring filter"
    },
    "session_id": {
      "type": "string",
      "description": "Session ID"
    }
  },
  "additionalProperties": false
}

session.record

Record a session turn (decision, breakthrough, summary) for compounding continuity. (READ-ONLY: mutations refused)

Argument	Type	Description
role	string	Who produced the turn
track	string	Optional track slug
content*	string	Turn content to persist
resolves	string	DiAML turn id of an earlier question, proposal, or hypothesis this turn resolves
qualifier	string	Epistemic qualifier for this turn
turn_type	string	Turn type (e.g. 'decision', 'milestone', 'observation', 'question', 'proposal', 'hypothesis')
importance	number	0.0 to 1.0 salience
session_id	string	Target session ID
supersedes	string	Memory id of an earlier turn this record replaces

Input schema (JSON)

{
  "type": "object",
  "required": [
    "content"
  ],
  "properties": {
    "role": {
      "enum": [
        "user",
        "ai"
      ],
      "type": "string",
      "description": "Who produced the turn"
    },
    "track": {
      "type": "string",
      "description": "Optional track slug"
    },
    "content": {
      "type": "string",
      "description": "Turn content to persist"
    },
    "resolves": {
      "type": "string",
      "description": "DiAML turn id of an earlier question, proposal, or hypothesis this turn resolves"
    },
    "qualifier": {
      "enum": [
        "verified",
        "hypothesis",
        "speculative",
        "conditional"
      ],
      "type": "string",
      "description": "Epistemic qualifier for this turn"
    },
    "turn_type": {
      "type": "string",
      "description": "Turn type (e.g. 'decision', 'milestone', 'observation', 'question', 'proposal', 'hypothesis')"
    },
    "importance": {
      "type": "number",
      "description": "0.0 to 1.0 salience"
    },
    "session_id": {
      "type": "string",
      "description": "Target session ID"
    },
    "supersedes": {
      "type": "string",
      "description": "Memory id of an earlier turn this record replaces"
    }
  },
  "additionalProperties": false
}

session.replay

Replay the chronological trajectory of a session: 'full' returns all turns, 'selective' filters by min_importance/turn_types, 'progressive' keeps the most recent turns within token_budget, and 'hybrid' combines earlier high-salience anchor turns (up to 30% of token_budget) with the most recent turns.

Argument	Type	Description
n	integer	Maximum turns (default 50)
mode	string	Replay mode (default full)
since	string	Time-range floor: epoch seconds, RFC 3339, or YYYY-MM-DD
track	string	Optional track slug to select the most recent prior session on this track
until	string	Time-range ceiling: epoch seconds, RFC 3339, or YYYY-MM-DD
session_id	string	Session ID
turn_types	array	Selective/hybrid mode: turn types to keep
token_budget	integer	Progressive/hybrid mode token budget (default 2000)
min_importance	number	Selective/hybrid mode floor (default 0.7)

session.start

Start or resume an agent session for persistent continuity across tool invocations.

Argument	Type	Description
user	string	User identifier (default: 'default')
title	string	Session title

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "User identifier (default: 'default')"
    },
    "title": {
      "type": "string",
      "description": "Session title"
    }
  },
  "additionalProperties": false
}

sutra.canon

Inspect the canonical 12-glyph logoglyphic Sutra canon, alchemical dual-mappings, Taoist hand seals (印诀), and bound Action Skeletons.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

sutra.cast

Evaluate and dispatch a zero-allocation Taoist Hand Seal / Sutra Codon (e.g. '觀證行', 'Kek-01-Seal'). Validates preconditions, computes Kekkai sandbox boundaries, and executes bound Action Skeleton cycles or transmits swarm mudra packet to P2P peer. (READ-ONLY: mutations refused)

Argument	Type	Description
peer	string	Target peer address (e.g. '152.53.195.47:7369') for remote Swarm Mudra Handoff via Wire Protocol 7369
codon*	string	Logoglyphic Sutra codon or Taoist hand seal sequence (e.g. '觀證行', 'Kek-01-Seal', '根界息')
track	string	Optional track slug for the recorded Sutra turn
strict	boolean	Fails closed if preconditions (read-only, landlock, mesh net) are unsatisfied
dry_run	boolean	Alias for !execute; if true, only validates preconditions and returns deterministic plan
execute	boolean	Whether to execute the bound Action Skeleton against the substrate (default: false / dry-run)
resolves	string	Optional DiAML turn ID resolved by this Sutra execution (defaults to latest open arc when omitted)
session_id	string	Optional session ID to record the executed Sutra DiAML turn into

sutra.compile

Compile high-level natural language intent into an optimal compound Sutra codon and Taoist Mudra formula using static Model2Vec embeddings or lexical centroids.

Argument	Type	Description
query*	string	High-level natural language intent or task description to compile into a Sutra codon

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "High-level natural language intent or task description to compile into a Sutra codon"
    }
  },
  "additionalProperties": false
}

sutra.hexagram

Inspect or mutate one of the 64 King Wen I Ching Hexagram Macro-Actions. Returns King Wen number, binary symbol, trigrams, Wu Xing element, default codon, nuclear inner, complement (反), reverse (覆), and dynamic line mutation transformations.

Argument	Type	Description
query*	string	Hexagram name, pinyin, King Wen number (1-64), or Unicode symbol (e.g. '既济', 'Qian', '1', '䷾')
mutate_line	integer	Optional line number (1 to 6, bottom to top) to mutate (flip yin/yang) and compute resulting hexagram and codon

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Hexagram name, pinyin, King Wen number (1-64), or Unicode symbol (e.g. '既济', 'Qian', '1', '䷾')"
    },
    "mutate_line": {
      "type": "integer",
      "maximum": 6,
      "minimum": 1,
      "description": "Optional line number (1 to 6, bottom to top) to mutate (flip yin/yang) and compute resulting hexagram and codon"
    }
  },
  "additionalProperties": false
}

sutra.list

List all recognized canonical compound Taoist Mudras (印诀式), their formulaic compositions, preconditions, and primary execution skeletons.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

sutra.route

Route an inquiry or task intent through the Catuṣkoṭi K3 dialectical cognitive router. Employs Kleene 3-valued logic to resolve dialectical tensions (competing action vectors like execute vs dry-run) and matches 64-hexagram macro-actions, returning System 0/1/2 triage tier, resting potential, plasticity, and bound Action Skeleton.

Argument	Type	Description
inquiry*	string	Task description, inquiry, or hexagram name to route
utility	number	Expected marginal utility threshold (default: 0.8)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "inquiry"
  ],
  "properties": {
    "inquiry": {
      "type": "string",
      "description": "Task description, inquiry, or hexagram name to route"
    },
    "utility": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Expected marginal utility threshold (default: 0.8)"
    }
  },
  "additionalProperties": false
}

Hosted router for available hosted tools. Use tools/list to discover supported routes.

Argument	Type	Description
args	object	Parameters for the routed tool
route	string	Explicit hosted tool route. Choose a supported tool from tools/list.
action	string	Legacy hosted action selector. Choose a supported tool from tools/list.
thought	string	Natural language query or command auto-routed via NLU

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "args": {
      "type": "object",
      "description": "Parameters for the routed tool"
    },
    "route": {
      "type": "string",
      "description": "Explicit hosted tool route. Choose a supported tool from tools/list."
    },
    "action": {
      "type": "string",
      "description": "Legacy hosted action selector. Choose a supported tool from tools/list."
    },
    "thought": {
      "type": "string",
      "description": "Natural language query or command auto-routed via NLU"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Required tags"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results"
    },
    "query": {
      "type": "string",
      "description": "Filter: every whitespace-separated term must appear"
    },
    "galaxy": {
      "type": "string",
      "description": "Galaxy to filter (default codex)"
    },
    "offset": {
      "type": "integer",
      "description": "Skip this many matching entries before returning (default 0)"
    },
    "exclude_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter: drop memories carrying any of these tags"
    },
    "created_after": {
      "type": "string",
      "description": "Filter: only memories created at or after this RFC 3339 timestamp"
    },
    "created_before": {
      "type": "string",
      "description": "Filter: only memories created at or before this RFC 3339 timestamp"
    },
    "max_importance": {
      "type": "number",
      "description": "Filter: maximum importance (0-1)"
    },
    "min_importance": {
      "type": "number",
      "description": "Minimum importance [0.0, 1.0]"
    }
  },
  "additionalProperties": false
}