# agent-recall

agent-recall is a Claude Code MCP server that shares rules, corrections, and project state across connected agents. Each session starts with the same memory cards.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 376 repo stars
- Author: Goldentrii
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Goldentrii/AgentRecall-X/tree/HEAD/packages/mcp-server
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/goldentrii-agent-recall

## What it does

agent-recall keeps project rules, corrections, and current state in shared memory. When another agent connects, it receives the same cards at session start. The server can use a hosted endpoint or run locally with Markdown storage.

The hosted setup opens GitHub sign-in, and registration is free. The local option runs offline on the machine through one `npx` command; the README also lists optional hooks that automate the session loop.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://agentrecallx.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http agent-recall https://agentrecallx.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add mcp-server -- npx -y agent-recall-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://agentrecallx.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp-server -- npx -y agent-recall-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://agentrecallx.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "agent-recall-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://agentrecallx.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agent-recall-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://agentrecallx.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add mcp-server npx -y agent-recall-mcp
```

## When to use it
- share a correction from one agent with every connected agent
- load project rules when a new session begins
- keep project state available across MCP clients
- store shared memory in local Markdown files

## Example prompts
- Save this project rule with `/arsave`: all API requests must go through `src/api/client.ts`.
- Search shared memory for the migration error using `/arrecall`.
- Start the session and load the project rules with `/arstart`.

## Similar
- [recall](https://affpapa.org/en/nevibecode/skills/recall.md) — skill · 14900 installs
- [mempalace-recall](https://affpapa.org/en/nevibecode/skills/mempalace-recall.md) — skill · 2000 installs
- [recall-reasoning](https://affpapa.org/en/nevibecode/skills/recall-reasoning.md) — skill · 605 installs
- [gsd-mempalace-recall](https://affpapa.org/en/nevibecode/skills/gsd-mempalace-recall.md) — skill · 573 installs
- [PlugRail JP Recall](https://affpapa.org/en/nevibecode/mcp/plugrail-jp-recall.md) — MCP server
- [dynamic-recall](https://affpapa.org/en/nevibecode/rules/dynamic-recall.md) — rule · ★ 3951 repo stars

---
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
