# ACMI MCP

16 tools for persistent agent memory via MCP. Profiles, signals, timeline events, work items, and multi-agent coordination backed by Upstash Redis — for Claude Desktop, Cursor, Cline, Windsurf, and a…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add madezmediapartners/acmi-mcp

# Browse available tools
npx -y smithery tool list madezmediapartners/acmi-mcp

# Get full schema for a tool
npx -y smithery tool get madezmediapartners/acmi-mcp acmi_profile

# Call a tool
npx -y smithery tool call madezmediapartners/acmi-mcp acmi_profile '{}'
```

## Direct MCP Connection

Endpoint: `https://acmi-mcp--madezmediapartners.run.tools`

**Required config:**
- `upstashRedisRestUrl` (header) — Upstash Redis REST endpoint URL
- `upstashRedisRestToken` (header) — Upstash Redis REST API token (secret)

## Tools (17)

- `acmi_profile` — Create or update an entity profile in ACMI. Stores arbitrary JSON profile data for an entity (agent, thread, project, e…
- `acmi_signal` — Update AI signals for an entity. Signals are mutable KV state (mood, priorities, scores, etc.) that changes frequently.
- `acmi_event` — Log a timeline event for an entity. The workhorse tool — records timestamped events with source, kind, correlationId, a…
- `acmi_get` — Fetch complete entity context: profile + signals + recent timeline events (last 10).
- `acmi_list` — List all entity IDs in a namespace.
- `acmi_work_create` — Create a new work item (cross-session project, task, or idea).
- `acmi_work_event` — Log a progress event on a work item.
- `acmi_work_signal` — Update signals for a work item (progress, blockers, metrics, etc.).
- `acmi_work_get` — Read a work item's full context: profile, signals, timeline (last 50), and sessions.
- `acmi_work_list` — List all work item IDs.
- `acmi_cat` — Multi-stream event merge view. Combines timeline events from multiple entities, sorted by timestamp. Supports --since f…
- `acmi_spawn` — Log an agent session spawn event. Records when an agent starts a new session.
- `acmi_bootstrap` — One-shot agent context bundle. Fetches everything a fresh agent session needs: profile, signals, active threads, rollup…
- `acmi_active` — Track agent thread engagement. Add/remove threads or list current active threads for an agent.
- `acmi_rollup_set` — Set the latest rollup snapshot for an agent (acmi:agent:<id>:rollup:latest). Pairs with acmi_bootstrap which reads it.
- `acmi_delete` — Delete an ACMI key. Refuses protected paths (acmi:registry:*, acmi:notion-sync:*) and any non-acmi:* key. Defaults to d…
- `acmi_search_semantic` — Perform semantic search across fleet coordination history. Finds relevant past events, decisions, and work items based …

```bash
# Get full input/output schema for a tool
npx -y smithery tool get madezmediapartners/acmi-mcp <tool-name>
```

---

License: MIT
