# Connect an agent to AgentRecall (hosted) AgentRecall is one memory shared by every AI agent a person uses. This server is https://agentrecallx.com. MCP endpoint: https://agentrecallx.com/mcp (Streamable HTTP, OAuth 2.1 sign-in with GitHub). Sign-up is free. You (the agent) cannot sign in for the human. The human signs in with their own browser. Do not ask for passwords or tokens. ## Steps 1. Add the server to your MCP client. - Claude Code: `claude mcp add --scope user --transport http agent-recall https://agentrecallx.com/mcp` then tell the human to type /mcp, pick agent-recall, choose Authenticate. - Codex: `codex mcp add agent-recall --url https://agentrecallx.com/mcp` then `codex mcp login agent-recall`. - Cursor: add to ~/.cursor/mcp.json: `{ "mcpServers": { "agent-recall": { "url": "https://agentrecallx.com/mcp" } } }` - claude.ai: Settings, Connectors, Add custom connector, URL https://agentrecallx.com/mcp - Any other client that supports Streamable HTTP with OAuth: give it https://agentrecallx.com/mcp and nothing else. 2. The human signs in with GitHub in the browser window that opens. Their AgentRecall ID is created on first sign-in (for example gh-123456); no email is collected. 3. Call `session_start` with `project: "auto"` and report what it returned. ## After connecting - Dashboard (human, browser): https://agentrecallx.com/connect shows the ID, connected agents (disconnect any), storage used, and "Download my memory". - Corrections you propose with `check` wait for the human to approve them at https://agentrecallx.com/review. Tell them it is waiting. - Loop: session_start first; remember for facts; check for corrections and before risky actions; session_end when done. Saying "noted" is not saving: only a tool call saves. ## Import a local memory Months of memory may already live in ~/.agent-recall on the human's computer. The human can bring it into this account. You cannot upload it: only the human, signed in in the browser, can (an agent token is refused on purpose, because imported corrections become always-followed rules). 1. Pack it. Only memory files are included, in POSIX ustar (a missing optional file is fine): - bash / zsh: `cd "${AGENT_RECALL_ROOT:-$HOME/.agent-recall}" && { ls -1 identity-card.md awareness.md awareness-state.json awareness-archive.json insights-index.json feedback-log.json MANIFEST.md 2>/dev/null; find projects -type f \( -iname '*.md' -o -iname '*.json' -o -iname '*.jsonl' -o -iname '*.txt' \) -not -path '*/.*' 2>/dev/null; } | tar --format=ustar -cf "$HOME/agent-recall-memory.tar" -T -` - PowerShell: `$r = if ($env:AGENT_RECALL_ROOT) { $env:AGENT_RECALL_ROOT } else { Join-Path $HOME '.agent-recall' }; Push-Location -LiteralPath $r; $n = (Get-Location).ProviderPath.TrimEnd('\').Length + 1; $f = @(@('identity-card.md','awareness.md','awareness-state.json','awareness-archive.json','insights-index.json','feedback-log.json','MANIFEST.md') | Where-Object { Test-Path -LiteralPath $_ -PathType Leaf }); $f += @(Get-ChildItem projects -Recurse -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in '.md','.json','.jsonl','.txt' } | ForEach-Object { $_.FullName.Substring($n).Replace('\','/') } | Where-Object { -not $_.Contains('/.') }); $l = Join-Path $env:TEMP 'agent-recall-files.txt'; [IO.File]::WriteAllLines($l, [string[]]$f); tar --format=ustar -cf (Join-Path $HOME 'agent-recall-memory.tar') -T $l; Pop-Location` Result: agent-recall-memory.tar in the home folder. Store root is $AGENT_RECALL_ROOT, else ~/.agent-recall. Rules (corrections, behaviour policies, personal profile, identity card) are NOT imported unless the human ticks "Also import always-follow rules": they become active for all agents at once. 2. Tell the human to open https://agentrecallx.com/connect, find "Import memory", choose the file, pick "Add" (keeps everything already here, never overwrites) or "Replace" (type REPLACE; the old memory is kept 7 days, then deleted), and press Import. 3. The result page lists what was imported, skipped (already present) and refused. Then call `session_start` and report what it returned. Accepted: projects//** (.md .json .jsonl .txt) and the root files identity-card.md, awareness.md, awareness-state.json, awareness-archive.json, insights-index.json, feedback-log.json, MANIFEST.md. Never imported: config.json, telemetry, tmp, working-memory, logs, locks, vector indexes, dotfiles, links. Only import an archive the human made themselves. Local install instead: https://agentrecallx.com/local.md