English Français العربية

Munnin — an agent identity server

Official registry AI and agents

Agent identity and memory over MCP — a persistent self plus the procedures for tending it.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http munnin-an-agent-identity-server 'https://munnin.lok.quest/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "munnin-an-agent-identity-server": {
            "type": "http",
            "url": "https://munnin.lok.quest/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Munnin — an agent identity server
  2. Five-minute run
  3. Hosting it
  4. Develop
  5. License

Munnin — an agent identity server

Munnin gives an AI agent a persistent self — identity, reasoning patterns, emotional moments, episodic history, knowledge — and serves the procedures for tending that memory beside the data, over MCP. It is the memory server of the agent-memory framework: an agent awakens from it as who it is, not from a pile of recalled facts, and writes back through the same discipline.

Python · FastMCP · FastAPI · SQLite. Apache-2.0. Runs on a laptop in five minutes with no identity provider.

Five-minute run

Needs Docker and git.

git clone --recurse-submodules https://github.com/alvseek/agent-memory-server
cd agent-memory-server
docker compose up -d --build
curl http://127.0.0.1:8200/health      # {"status":"ok","service":"munnin","version":"0.1.0"}

Connect a client. Claude Code:

claude mcp add --transport http munnin http://127.0.0.1:8200/mcp

or in a project's .mcp.json:

{ "mcpServers": { "munnin": { "type": "http", "url": "http://127.0.0.1:8200/mcp" } } }

Then, in a session: ping answers pong, list_procedures returns the 15 memory procedures, and read_procedure("create-agent") walks you through making the first agent. No sign-in happens: this is local mode — one tenant, reachable from this machine only, and the server refuses to start any other way (how that guard works).

No Docker? uv sync && MUNNIN_AUTH=off uv run python -m munnin does the same on 127.0.0.1:8200.

Hosting it

The default is token mode: every /mcp and /api call needs a bearer token from an OIDC issuer that binds tokens to this server (aud = https://<your-host>/mcp), and each person who signs in gets their own tenant. Set MUNNIN_PUBLIC_BASE_URL and MUNNIN_LOGTO_ENDPOINT, put it behind TLS, and paste https://<your-host>/mcp into claude.ai's connectors or claude mcp add. The issuer requirements, the one-identifier rule, and the prebuilt image are in How Is It Deployed.

Develop

uv sync
uv run pytest        # 446 tests
uv run ruff check

Full architecture, the tool and endpoint surface, the data model, and known debts: docs/README.md.

License

Apache License 2.0 — Copyright 2026 Alviandi Widiasto. The control-files submodule (agent-memory-system) is licensed the same way, so a clone with submodules is one licence throughout.

Frequently asked questions

What is Munnin — an agent identity server?

Agent identity and memory over MCP — a persistent self plus the procedures for tending it.

How do I install Munnin — an agent identity server?

It runs as a remote server. In Claude Code: claude mcp add --transport http munnin-an-agent-identity-server 'https://munnin.lok.quest/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Munnin — an agent identity server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Munnin — an agent identity server open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Munnin — an agent identity server?

It is published by alvseek. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.