skills.rest
Prismaibrowser
PrismaibrowserOFFICIAL
Explore all skills by this author →
GitHub

agentmemory-rest-api

Exposes the agentmemory memory server over HTTP REST endpoints for save, recall, and search operations.

3|Updated Oct 25, 2025
Search Tags:#REST API#http#endpoints#agent memory#curl#mcp fallback#memory server
One-click install
npx skills add https://github.com/Prismaibrowser/prismspace-web --skill agentmemory-rest-api-prismaibrowser
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentmemory-rest-api
Source: https://github.com/Prismaibrowser/prismspace-web/tree/main/.agents/skills/agentmemory-rest-api
Command: npx skills add https://github.com/Prismaibrowser/prismspace-web --skill agentmemory-rest-api-prismaibrowser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When MCP is unavailable or a host does not speak MCP, you still need a reliable way to store and retrieve agent memories. This Skill documents the agentmemory HTTP REST API, the primary protocol surface of the memory server, so any HTTP client can perform memory operations directly. ## Core Features & Use Cases - Full REST Surface: Access 130 registered endpoints under http://localhost:3111/agentmemory/* covering remember, smart-search, sessions, checkpoints, graph queries, and more. - MCP Fallback: Use REST as the fallback protocol when MCP tooling is unavailable, since MCP is a bridge on top of this API. - Simple Auth Model: Localhost is open by default; when AGENTMEMORY_SECRET is set, send Authorization: Bearer $AGENTMEMORY_SECRET. - Use Case: An external automation script needs to persist a decision. It POSTs to /agentmemory/remember with content and concepts, then later recalls it via /agentmemory/smart-search with a natural-language query. ## Quick Start Ask the agent to save a memory by POSTing to http://localhost:3111/agentmemory/remember with a JSON body containing content and concepts, then verify with a smart-search query.

Frequently Asked Questions about agentmemory-rest-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a memory using the agentmemory REST API?▼

Save a memory by sending a POST request to http://localhost:3111/agentmemory/remember with a JSON body containing a content field and an optional concepts array. A successful save returns HTTP 201.

How to search agent memories over HTTP?▼

Search memories by POSTing to /agentmemory/smart-search with a JSON body containing a query string and a limit. The endpoint returns matching memories ranked by relevance to your natural-language query.

Does the agentmemory REST API require authentication?▼

Authentication is optional on localhost, which is open by default. When the AGENTMEMORY_SECRET environment variable is set, every request must include an Authorization: Bearer header with that secret.

When should I use the REST API instead of MCP tools?▼

Use the REST API when MCP is unavailable or when integrating a host that does not speak MCP. REST is the primary surface of agentmemory, and MCP is implemented as a bridge on top of it.

What HTTP status codes does the agentmemory API return?▼

Save operations return 201, read operations return 200, and validation errors return 400. Handlers whitelist body fields and silently drop unknown keys, so extra fields are ignored.

Can I change the default port 3111 of the memory server?▼

Yes, the port is configurable with the --port or --instance flags when starting the server. Derived services such as streams, viewer, and engine ports are computed from the base port.

Related Skills

Explore More Software Engineering Skills→
kriegcloudkriegcloud
68

portless

Replace local development port numbers with named .localhost domains.

Community
Intermediate
MohabsmarMohabsmar

elite-longterm-memory

Implement layered memory with LanceDB, Git-notes, and Write-Ahead Logging.

Community
Advanced
webzlerwebzler
30

agentMemory

Synchronize markdown memory banks across KiloCode, Cline, and RooCode via MCP.

Official
Advanced
Aum08DesaiAum08Desai

mcporter

Manage MCP servers and tools via a CLI over HTTP or stdio.

Community
Intermediate