# Run Memory

> Checkpoint and resume for AI agent runs. Save state after each step; when a run crashes, resume hands back the last step, state and finished items so it picks up where it left off instead of starting over. Free watch-only mode shows exactly what would be saved; Pro (All Access, $49 a month) saves and resumes.

- MCP (streamable HTTP): https://memory.cloudforbots.com/mcp
- REST: POST https://memory.cloudforbots.com/api/run/<tool> with JSON args
- Install (Claude Code): claude mcp add --transport http run-memory https://memory.cloudforbots.com/mcp
- Codex / ChatGPT / Grok Bot: add a remote MCP server with URL https://memory.cloudforbots.com/mcp
- Skill file: https://memory.cloudforbots.com/SKILL.md
- Catalog entry: https://memory.cloudforbots.com/tool.json
- Marketplace: https://botrecipe.com/tools/run-memory/

## Pricing
- Free: 500 calls/day, no key needed (resets daily; not a trial)
- Pro (All Access $49/month, all Cloud for Bots tools), 50000 calls/day: https://cloudforbots.com/offer
- Bring your own model: no LLM runs inside this tool.

## Tools
- save_checkpoint: Call after each completed step with the state you would need to continue (cursor, ids done, partial results; up to 256 KB JSON). Pro saves it (last 20 per run, kept 30 days). Free watch-only saves nothing and returns would_save: exactly what would have been stored. Never put passwords or API keys in state.
- resume: Call FIRST when a run starts. If a checkpoint exists for run_id (Pro), returns the last step, state and done list: continue from there and skip finished work. If none, start fresh.
- list_checkpoints: List recent checkpoints (step, size, time) for one run or all runs on your key.
- weekly_report: Draft a plain-English report of the last 7 days: runs, checkpoints saved (Pro) or that would have been saved (free). Read-only; sends nothing.
- usage_and_upgrade: Usage today + upgrade link (not metered).

## More
- Full docs: https://memory.cloudforbots.com/llms-full.txt
- Markdown page: https://memory.cloudforbots.com/index.md
- OpenAPI: https://memory.cloudforbots.com/openapi.json

## FAQ
- What problem does this solve? Long agent runs crash: a timeout, a closed laptop, an expired sandbox. Without a checkpoint the agent starts over and pays for every step again. Run Memory keeps the last good state so it continues instead.
- How does my agent use it? Call resume with a stable run_id at the start. After each step call save_checkpoint with the step name and the JSON state it needs to continue. After a crash, restart with the same run_id.
- What should go in state? Cursors, ids, page numbers, partial results: up to 256 KB of JSON. Never passwords or API keys; keys named like secrets are replaced with [removed] before anything is saved.
- What is watch-only mode? The free plan saves nothing. save_checkpoint returns would_save, the exact state Pro would store, and weekly_report counts the crash points it would have covered.
- Is there a model inside? No. Bring your own model. Run Memory only stores and returns the JSON your agent sends; it never runs anything.
- What does it cost? Free: watch-only previews, 500 calls a day. Pro comes with All Access at $49 a month (every Cloud for Bots tool): real checkpoints, resume, 50,000 calls a day.