agentmemory-rest-api

Agent Skills › rohitg00/agentmemory › agentmemory-rest-api

agentmemory-rest-api

GitHub

提供 agentmemory 的 HTTP REST API 接口，用于在 MCP 不可用或主机不支持时作为备选通信方案。支持通过 localhost:3111 端口进行记忆的保存与检索，并包含认证配置及约定说明。

plugin/skills/agentmemory-rest-api/SKILL.md rohitg00/agentmemory

Trigger Scenarios

需要调用 agentmemory 的 HTTP REST API MCP 协议不可用时需使用 fallback 方案集成不支持 MCP 的主机系统

Install

npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -g -y

More Options

Non-standard path

npx skills add https://github.com/rohitg00/agentmemory/tree/main/plugin/skills/agentmemory-rest-api -g -y

Use without installing

npx skills use rohitg00/agentmemory@agentmemory-rest-api

指定 Agent (Claude Code)

npx skills add rohitg00/agentmemory --skill agentmemory-rest-api -a claude-code -g -y

安装 repo 全部 skill

npx skills add rohitg00/agentmemory --all -g -y

预览 repo 内 skill

npx skills add rohitg00/agentmemory --list

SKILL.md

Frontmatter

{
    "name": "agentmemory-rest-api",
    "description": "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.",
    "user-invocable": false
}

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

# 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.

Version History

a8e7d19 Current 2026-07-24 11:39

Metadata

Files: 0
Version: d219763
Hash: e7014241
Indexed: 2026-07-24 11:39

agentmemory-rest-api