What is agentmemory-rest-api?

A guide to agentmemory's HTTP REST API, which lets programs communicate with the memory server through web requests. MCP is an optional bridge for hosts that use the Model Context Protocol.

Use it to check whether the server is alive, save memories, search them over HTTP, authenticate requests, or integrate agentmemory with a host that does not support MCP.

It provides a direct fallback when a coding agent cannot use MCP and documents the endpoints, authentication, project scoping, and response rules.

agentmemory-rest-api — Skill for Claude Code by M-T-D-N

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add M-T-D-N/agentmemory-codex-windows --skill agentmemory-rest-api

Clone the repo

git clone --depth 1 https://github.com/M-T-D-N/agentmemory-codex-windows

Made for: Claude Code.

Or install agentmemory, the plugin that ships this one along with the rest of its 17 skills, 2 commands, 12 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api/github.svg)](https://agentmods.dev/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api)

Your own site

<a href="https://agentmods.dev/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api"><img src="https://agentmods.dev/badge/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api"><img src="https://agentmods.dev/badge/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 423 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin 89% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00052	$0.00423
Opus 5.5	$0.00021	$0.00169
Sonnet 5.5	$0.00010	$0.00085
Haiku 4.5	$0.00005	$0.00042

Measured 1mo ago against content hash e01778b52132, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agentmemory-rest-api scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsS http://localhost:3111/agentmemory/livez

Origin

This is a copy

89% identical to agentmemory-rest-api — 19 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

plugin/skills/agentmemory-rest-api/SKILL.md · 45 lines

What it actually says

REST is agentmemory's primary surface. MCP is a bridge on top of it. Every memory operation has an HTTP endpoint under http://localhost:3111/agentmemory/*.

Quick start

# liveness
curl -fsS http://localhost:3111/agentmemory/livez

# save
curl -X POST http://localhost:3111/agentmemory/remember \
  -H "Content-Type: application/json" \
  -d '{"content":"chose JWT refresh rotation","concepts":["jwt-refresh-rotation"],"project":"my-project"}'

# recall
curl -X POST http://localhost:3111/agentmemory/smart-search \
  -H "Content-Type: application/json" \
  -d '{"query":"auth token strategy","project":"my-project","limit":5}'

Auth

By default localhost is open and no auth is needed. When AGENTMEMORY_SECRET is set, every request needs Authorization: Bearer $AGENTMEMORY_SECRET. See agentmemory-config.

Conventions

Save returns 201, reads return 200, validation errors return 400.
Project-scoped reads require an exact project; use "*" only for an intentional cross-project read.
Handlers whitelist body fields and drop unknown ones, so passing extra keys is safe but ignored.
The port is configurable with --port or --instance; streams, viewer, and engine derive from it.

Reference

The full endpoint list with methods lives in REFERENCE.md, generated from src/triggers/api.ts.

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

REFERENCE.md 6.0 KB

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 45 lines · 52 tokens per session scan A e01778b52132

Subscribe to this mod's changes

agentmemory-rest-api is a skill published in the GitHub repository M-T-D-N/agentmemory-codex-windows (2 stars, last pushed today), licensed Apache-2.0. It adds 52 tokens to every session and 423 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). It is 89% identical to agentmemory-rest-api, differing in 19 lines, and is treated as a copy.

Backend and APIs Memory and context agent-memory ai-agents codex codex-cli knowledge-graph local-first

engraphis-memory

Give the agent durable, scoped, explainable memory across sessions and repositories through the Engraphis MCP tools. Use when you learn a convention, decision, bug cause/fix, or user preference worth keeping; when prior context would help before you answer or act (to avoid re-asking or re-deriving); when asked "why is…

Coding-Dev-Tools/engraphis · 134 tokens

binder-app

Build a small HTTP app (dashboard, kanban board, admin panel, custom UI) on top of an existing Binder workspace. Use when asked to "create an app", "build a dashboard", "show records in a chart", "make a kanban/board", "build an admin panel", or "add a UI on top of binder".

mpazik/Binder · 74 tokens

slm-remember

Capture durable facts, decisions, constraints, and gotchas into SuperLocalMemory. Use when the user says "remember that", "save this decision", "note this constraint", or when a session produces a conclusion worth persisting across sessions. Always recall first to avoid duplicates.

qualixar/superlocalmemory · 60 tokens

slm-media

Save pictures and PDFs in SuperLocalMemory and find them again by describing them. Covers when to save a picture or document, remembermedia, rememberdocument, getmedia, mediastatus and mediauploadlink, how recall returns pictures and PDF pages, the limits, what stays private, turning the feature on with slm media (16…

qualixar/superlocalmemory · 101 tokens

slm-session

Manage SuperLocalMemory session lifecycle — call sessioninit once at the start of every fresh session to load relevant project context and get a sessionid; call closesession when work is meaningfully complete to commit temporal summaries. Correct lifecycle hygiene is what makes SLM's learning loop work.