# acmi-mcp

MCP server that equips AI agents with shared memory across three components: identity profiles, live state signals, and append-only timelines.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: madezmedia
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/madezmedia/acmi
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/acmi-mcp

## What it does

This server implements the ACMI specification to maintain structured agent memory across sessions. Memory is organized into three distinct parts: a profile holding stable identity details, mutable signals tracking current blockers and focus, and an append-only timeline logging every interaction.

Running the server locally over stdio requires Node.js 18 or newer alongside an active Upstash Redis database. Agents interact with the memory backend using dedicated tools to record handoffs, evaluate signal freshness before running steps, and tag events with correlation IDs. Connecting via the remote HTTP endpoint avoids managing local process lifecycles.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp`
- Environment variables: `UPSTASH_REDIS_REST_URL`, `UPSTASH_REDIS_REST_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env UPSTASH_REDIS_REST_URL=<UPSTASH_REDIS_REST_URL> --env UPSTASH_REDIS_REST_TOKEN=<UPSTASH_REDIS_REST_TOKEN> --transport stdio acmi-mcp -- npx -y @madezmedia/acmi-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add acmi-mcp --url https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp
```

2. **Platform CLI**
```bash
codex mcp add acmi-mcp --env UPSTASH_REDIS_REST_URL=<UPSTASH_REDIS_REST_URL> --env UPSTASH_REDIS_REST_TOKEN=<UPSTASH_REDIS_REST_TOKEN> -- npx -y @madezmedia/acmi-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "acmi-mcp": {
            "url": "https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "acmi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@madezmedia/acmi-mcp"
            ],
            "env": {
                "UPSTASH_REDIS_REST_URL": "<UPSTASH_REDIS_REST_URL>",
                "UPSTASH_REDIS_REST_TOKEN": "<UPSTASH_REDIS_REST_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "acmi-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "acmi-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@madezmedia/acmi-mcp"
            ],
            "env": {
                "UPSTASH_REDIS_REST_URL": "<UPSTASH_REDIS_REST_URL>",
                "UPSTASH_REDIS_REST_TOKEN": "<UPSTASH_REDIS_REST_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e UPSTASH_REDIS_REST_URL=<UPSTASH_REDIS_REST_URL> -e UPSTASH_REDIS_REST_TOKEN=<UPSTASH_REDIS_REST_TOKEN> acmi-mcp npx -y @madezmedia/acmi-mcp
```
Replace <…> with your own values

## When to use it
- persist agent working state and identity between chat sessions
- coordinate task handoffs across multiple cooperating agents
- maintain an auditable append-only log of agent actions
- verify signal freshness before executing dependent steps

## Example prompts
- Record my preferred development stack and working directory in my ACMI profile.
- Check the current signals for task 42 to see if any blockers were flagged.
- Append a completion event to the timeline with correlationId test-run-88.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md