Skip to main content

Memanto Cloud API

The Memanto Cloud API is the HTTPS API behind the memanto CLI, the MCP server and the console when they use Memanto Cloud. Call it from any language to give your own app or agent memory, with nothing to host. It covers the same operations as the local REST API, with two differences:
  • No sessions. There is no activate or deactivate step and no session token. Every request carries your API key.
  • No /api/v2 prefix. Paths start at the agent: /agents/{agent_id}/remember.

Base URL

The memanto CLI reads the base URL from MEMANTO_API_URL when it is set.

Authentication

Every request needs an API key in the x-api-key header:
Create a key in the console under API keys. Keys start with mk_. A computer signed in with memanto login has its own key, saved as MEMANTO_API_KEY in ~/.memanto/.env. A key acts as its owner: it can use the agents you own and the agents other people shared with you. Creating agents needs an account admin’s key.

Quick start

Attributing calls to a tool

Send source (a tool slug such as cursor, or your app’s name) on writes and reads. The console’s Connections page and the By tool usage card group activity by it. See Tool attribution.

Errors

Errors return a JSON body with a message in detail, message or error, depending on the endpoint.

Limits

  • Memory content: up to 10,000 characters; title up to 100; up to 20 tags of up to 64 characters.
  • Batch Remember: up to 100 memories per call.
  • Recall limit: 1–100.
  • API keys: 3 per account, plus one per signed-in computer (up to 10).
  • Agents and monthly usage depend on your plan. Get Account returns your current usage and limits.