Agent Memory Bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CODEX_HOME | No | Path to the Codex home directory (e.g., %USERPROFILE%\.codex) | |
| AGENT_MEMORY_BRIDGE_HOME | No | Path to the Agent Memory Bridge home directory (e.g., %USERPROFILE%\.codex\mem-bridge) | |
| AGENT_MEMORY_BRIDGE_CONFIG | No | Path to the Agent Memory Bridge configuration file (e.g., %USERPROFILE%\.codex\mem-bridge\config.toml) | |
| AGENT_MEMORY_BRIDGE_RUN_ONCE | No | Set to "1" to run only one cycle instead of continuous operation |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| storeA | Store one entry in the bridge for later retrieval or coordination. Use this tool when you want to persist a compact memory record or write a signal
that another workflow can poll later. Write durable knowledge as Returns the stored entry identifier, timestamp, and duplicate information. Repeated
|
| recallA | Recall matching entries or poll for new signals from the bridge. Use this tool to search durable memory, filter by metadata, or poll for fresh
coordination signals. For issue-like work, prefer project and domain recall before
external search. For workflow polling, pass Empty-query Signal recall returns a |
| browseA | Browse recent items when you do not yet know what to search for. Use this tool to inspect a namespace by filters alone. It is useful when you want to see recent memory, scan a domain bucket, or confirm that signals are flowing before writing a more specific recall query. |
| statsA | Return a quick health summary for one namespace. Use this tool when you want to inspect what is in the bridge without opening SQLite directly. It returns total item count, a kind breakdown, top domains, and the oldest and newest entry timestamps for the namespace. |
| forgetA | Delete one stored entry by id. Use this tool to remove a bad memory, an accidental write, or a signal that should no longer exist. The response tells you whether anything was deleted and returns the removed item metadata when a match is found. |
| feedbackA | Record structured retrieval feedback for one recalled memory result. Evidence is append-only/shadow-only. Provenance is caller-declared and not authenticated. This tool does not mutate memory records, recall results, or ranking behavior. |
| promoteA | Manually promote one stored memory to a stronger durable record type. Use this tool when you know a record should be treated as a learn, gotcha, or domain note even if the reflex layer has not promoted it yet. Promotion keeps the same id and updates the stored title, tags, and structured content in place. |
| annotateA | Explicitly enrich one durable memory without pretending the write was a new fact. Use this after |
| reviseA | Create a new durable memory that explicitly supersedes an older record. The predecessor remains available for audit. The bridge adds an exact |
| exportA | Export bridge content into a readable or portable format. Use this tool when you want to inspect a namespace outside the MCP client, create a human-readable snapshot, or move memory into another system without opening the database directly. |
| begin_runA | Start one explicit, stateless run and return server-minted run/work-item IDs. The bridge does not retain an implicit current run. Callers must pass the returned handles to later event, read, and completion calls. Idempotent retries return the same handles and reject conflicting payloads. |
| record_run_eventA | Append one structured event to a run's durable authority ledger. Sequence allocation, event persistence, child work-item creation, and projection updates occur in one transaction. This tool never sets an implicit current run. |
| get_runA | Read current run/work-item projections plus append-only events for reconnect or compaction recovery. |
| complete_runA | Append or correct a run outcome without changing memory ranking or policy. On new runs, |
| claim_signalA | Claim one signal with a short lease for lightweight work coordination. Use this when a worker should take ownership of a pending signal before it acts.
If |
| extend_signal_leaseA | Extend the active lease on one claimed signal. Use this when a worker still owns a signal but needs more time before another consumer can reclaim it. Expired leases cannot be extended; those signals must be reclaimed instead. Hard signal expiry still takes precedence over lease renewal. |
| ack_signalA | Acknowledge one claimed or pending signal so downstream polling can stop treating it as active work. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Most tools have clearly distinct purposes, with a few pairs like recall/browse and promote/annotate/revise that could be initially confused but are well-delineated by descriptions. Overall, an agent can reliably select the right tool for memory, signal, or run operations.
The majority of tool names follow an imperative verb or verb_noun pattern (store, recall, begin_run, ack_signal), but a few nouns like 'feedback' and 'stats' break the convention. This mixed style is still readable but not fully consistent.
At 17 tools, the set is on the heavier side, though the complex domain of memory plus run/signal coordination justifies most entries. It sits at the boundary where agents might find the surface area slightly overwhelming.
The tools cover the full memory lifecycle (create, read, update, delete) and provide robust run and signal workflows. Minor gaps exist, such as no direct get-memory-by-id or list-runs operation, but existing tools accommodate these needs reasonably well.