acmi-mcp — Claude Code MCP server: what it does, how to install
MCP server that equips AI agents with shared memory across three components: identity profiles, live state signals, and append-only timelines.
claude mcp add --transport http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcpWhat acmi-mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install acmi-mcp
1Platform CLI: remote server
claude mcp add --transport http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp2Platform CLI
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-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add acmi-mcp --url https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp2Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"acmi-mcp": {
"url": "https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp"
}
}
}{
"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
Config file
{
"servers": {
"acmi-mcp": {
"type": "http",
"url": "https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp2Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about acmi-mcp
How do I install acmi-mcp in Claude Code?
Run claude mcp add --transport http acmi-mcp https://server.smithery.ai/@madezmediapartners/acmi-mcp/mcp to connect to the hosted endpoint.
What does acmi-mcp do?
It provides tools for agents to query and persist context in Redis. The memory architecture partitions context into identity profiles, active signals, and sequential timeline events.
What prerequisites are required to run acmi-mcp locally?
Local stdio execution demands Node.js 18 or above, plus UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN environment variables.
