agentmemory-rest-api

Original：🇺🇸 English

Translated

The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server. Use when calling agentmemory over HTTP, when MCP is unavailable and you need a fallback, or when integrating a host that does not speak MCP.

210installs

Sourcerohitg00/agentmemory

Added on2026-06-08

NPX Install

npx skill4agent add rohitg00/agentmemory agentmemory-rest-api

SKILL.md Content

View Translation Comparison →

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

bash

# 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"]}'

# recall
curl -X POST http://localhost:3111/agentmemory/smart-search \
  -H "Content-Type: application/json" \
  -d '{"query":"auth token strategy","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
```
.
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

.