Agentmemory Rest Api

This is the HTTP fallback for when you can't use MCP to talk to agentmemory. Every memory operation gets a REST endpoint under localhost:3111, so you can POST to /remember to save facts with concepts, hit /smart-search to recall them, and check /livez for health. It's actually the primary interface, MCP is just a bridge on top. Auth is optional via bearer token when you set AGENTMEMORY_SECRET. The endpoints are straightforward: 201 for writes, 200 for reads, 400 for bad input. If you're integrating agentmemory into something that doesn't speak MCP or you need a simple curl-able API for testing, this is what you want.

skills.sh installs: 11.4K
GitHub stars: 30.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rohitg00/agentmemory --skill agentmemory-rest-api --agent claude-code

Installs into .claude/skills of the current project.

Files

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

# For this fixed loopback URL only. Do not print the value or enable shell tracing.
agentmemory_secret="${AGENTMEMORY_SECRET:-$(cat "$HOME/.agentmemory/secret")}"
test -n "$agentmemory_secret" || exit 1

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

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