agentmemory-rest-api

agentmemory-rest-api is a skill for Claude Code, Codex from M-T-D-N/agentmemory-codex-windows. It costs 52 tokens per session (423 once invoked), scanned A, a copy of agentmemory-rest-api, Apache-2.0.

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.

In plain words
What is it for?
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.
Why use it?
It provides a direct fallback when a coding agent cannot use MCP and documents the endpoints, authentication, project scoping, and response rules.

Skill for Claude CodeCodex

Part of the agentmemory plugin — 17 skills, 2 commands, 12 hooks, 1 MCP server shipped together

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.

agentmods
npx agentmods add skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api
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, Codex.

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.

agentmods badge for agentmemory-rest-api

README.md
[![agentmods](https://agentmods.dev/badge/skills/m-t-d-n/agentmemory-codex-windows/agentmemory-rest-api.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.svg" alt="Measured on agentmods" 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. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5 $0.00052 $0.00423
Opus 5 $0.00026 $0.00211
Sonnet 5 $0.00010 $0.00085
Haiku 4.5 $0.00005 $0.00042

Measured 4d ago against content hash e01778b52132, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 4d 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 — 5 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.

See also

  • agentmemory-mcp-tools for the MCP equivalents.
  • agentmemory-config for the port quartet and the secret.

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.

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.

  1. 4d 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 4d ago), licensed Apache-2.0. It adds 52 tokens to every session and 423 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). It is 89% identical to agentmemory-rest-api, differing in 5 lines, and is treated as a copy.

Related

Other skills, from other repositories

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

talamus-memory

Set up and use Talamus as durable, local-first memory for AI agents. Use when an agent needs to initialize or diagnose a Talamus brain, ingest files or repositories, retrieve cited context across sessions, inspect note history, verify memory against sources, review proposed corrections, connect Talamus through MCP, or…

ampres-ai/talamus · 76 tokens

shodh-memory

Persistent memory system for AI agents. Use this skill to remember context across conversations, recall relevant information, and build long-term knowledge. Activate when you need to store decisions, learnings, errors, or context that should persist beyond the current session.

varun29ankuS/shodh-memory · 53 tokens

plur-memory

Persistent learning for AI agents. Open engram format. Your agent learns from corrections, remembers across sessions, and transfers knowledge across domains.

plur-ai/plur · 31 tokens

lemmalog

Externalize working memory and logical state into the lemmalog Datalog engine (MCP). Use for ANY multi-step task where state should outlive one context window or span agents: long investigations, debugging sessions, audits, multi-agent searches, systematic explorations, planning with many interdependent constraints…

JordyZomer/lemmalog · 105 tokens

ori-memory

Persistent agent memory with learning retrieval. Knowledge graph on markdown files — capture insights, decisions, research, and learnings during work, then retrieve them weeks or months later. Use when knowledge is too valuable to lose but too much to inject into every prompt.

aayoawoyemi/Ori-Mnemos · 54 tokens