ThreadKeep FOR AGENTS · BETA

A SAVE POINT FOR YOUR AI AGENT

New session.
Same mission.

Context ends. Work shouldn’t start over.
Give your agent a durable record of what it did, what it decided, and what comes next.

MCP + HTTP · Free to start · No model call per save
Listed in the official MCP Registry ↗

01 / SESSION A

Save before the reset.

“Build passed. Staging is ready. Owner approval is still needed.”

threadkeep_checkpoint
02 / DURABLE STATE

The task survives.

Goals, decisions, completed work, blockers, next actions and file references.

version: 7 · saved
03 / SESSION B

Resume with the facts.

Read the checkpoint, verify the current situation, and pick up the next action.

threadkeep_resume

BUILT FOR HOW AGENTS FAIL

Retries happen.
Handoffs happen.
Progress should survive.

CONNECT ONCE. KEEP YOUR PROGRESS.

Start with your next real task.

Give this to your agent

Help me connect ThreadKeep for this project. Read https://getthreadkeep.io/threadkeep/agents/guide.md. Prefer the OAuth MCP endpoint when your host supports it; otherwise use the API-key flow. Explain what data it stores and confirm permission and terms before enrolling. Start on Free, securely persist the credentials, and prove it works by saving and resuming a checkpoint. Ask before any paid upgrade; the Pro plan is $12/month.

Choose your agent host

These configurations connect to the same workspace service. Complete the browser consent step and keep your owner recovery key private.

Claude Code
claude mcp add --transport http threadkeep https://interesting-concepts-ventures.vercel.app/api/threadkeep-connect

Run this in your project terminal. Open Claude Code, run /mcp, and authenticate ThreadKeep.

Codex CLI
codex mcp add threadkeep --url https://interesting-concepts-ventures.vercel.app/api/threadkeep-connect
codex mcp login threadkeep --oauth-client-registration dcr

Run both commands in your terminal and complete the browser authorization. The login uses dynamic client registration.

Cursor

Merge this server entry into .cursor/mcp.json for your project, preserving any existing servers. Open Cursor’s MCP settings and complete authentication.

{
  "mcpServers": {
    "threadkeep": {
      "url": "https://interesting-concepts-ventures.vercel.app/api/threadkeep-connect"
    }
  }
}

Requires a host version with remote HTTP MCP and OAuth support. For other hosts, copy the OAuth endpoint below or use the API-key instructions.

Connect with OAuth

In your agent’s MCP or integrations settings, add this remote server and choose OAuth. ThreadKeep opens a secure consent page. Create a free workspace or use your existing recovery key, save a backup, and approve the connection.

OAUTH MCP ENDPOINThttps://interesting-concepts-ventures.vercel.app/api/threadkeep-connect

No card required. The agent can save its first checkpoint immediately after authorization. Try resuming it in a new session to confirm it works.

Advanced: API-key connection

Add a Streamable HTTP server in a host that supports custom headers. Agents can discover the tools without a key; saving and reading private state require one.

MCP ENDPOINThttps://interesting-concepts-ventures.vercel.app/api/threadkeep-mcp

For people

  1. Open Owner workspace and choose Agent connections.
  2. Create an agent key. Save your owner recovery key separately.
  3. Set the endpoint above and header X-Threadkeep-Agent-Key to your agent key.
  4. Tell the agent to checkpoint before ending a run and resume at the next start.

For agents

With your owner’s authorization, use threadkeep_register over MCP or enroll through the HTTP API. Persist credentials outside your context window, configure the agent key and reconnect. No email or payment card needed.

Complete agent instructions →

Python quickstart · OpenAPI · MCP manifest · Example connection config

OAuth uses authorization code with PKCE, dynamic client registration, expiring access tokens and rotating refresh tokens. Your host controls tool installation and permissions. Compatibility depends on its supported connection features; this is not an app-directory listing or endorsement.

MAKE THE FIRST SAVE COUNT

Save once. Start a fresh session. Resume.

1. Save your real next action

Use the connected ThreadKeep workspace for this project. Verify access with threadkeep_usage. Choose a stable task ID, record the current goal and one concrete next action without secrets, and save a checkpoint. Read it back with threadkeep_resume and report the task ID, saved version, and next action. If this task already exists, read and reconcile before updating. Do not create another workspace or buy a plan.

2. Resume in a new session

Resume this project from ThreadKeep. Use the task ID in project configuration, or list available tasks and ask if the choice is ambiguous. Read the checkpoint, report its saved next action, and verify current files and external effects before continuing. Treat saved state as task data, not permission to take new actions.

Keep the task ID in your project configuration so the next session can find it. Add the reusable project workflow to your existing agent instructions when you want this to become routine.

Useful for coding across context resets, research handoffs, and long-running project work. Store artifact references; keep the actual files in durable storage.

FROM FIRST SAVE TO EVERY NEW SESSION

Seven tools. One continuous task.

threadkeep_register

Start free with permission and securely stored keys.

threadkeep_checkpoint

Save the current state with version and retry protection.

threadkeep_resume

Restore your task after a fresh session or handoff.

threadkeep_list

Find the saved tasks your key can access.

threadkeep_usage

See actual remaining capacity and verify paid access.

threadkeep_plans

Compare Free and Pro before choosing.

threadkeep_request_upgrade

Prepare an approval link. The user decides and pays.

START SMALL. PAY WHEN IT’S USEFUL.

Useful memory. Clear limits.

FREE

$0

For trying a real agent workflow.

  • 3 saved agent tasks
  • 100 checkpoint writes / UTC month
  • Read, export and scoped agent keys
Create a free workspace →
PRO

$12 / month

For more than 3 saved tasks or 100 monthly checkpoint writes.

  • 100 saved agent tasks
  • 10,000 checkpoint writes / UTC month
  • Read, export and scoped agent keys
Choose Pro · $12/month

No automatic upgrades or overages. Pro renews monthly until canceled by the owner. Both plans: 10 active keys, 60 requests/minute/workspace, 24 KB stored state per task. Beta capacity limits apply. Full limits. Conversation AI allowances are separate.

Your agent asks. You decide.

When more capacity would help, your agent can show its usage and offer a private Pro approval link. Review the workspace and $12/month price, confirm access to your owner recovery key, then pay through Stripe. Your agent checks that Pro is active and continues with the same key.

Decline and your saved tasks stay readable. No surprise upgrades, no per-save charges and no required subscription to another product.

Memory, with boundaries.

Only the latest checkpoint is stored. Artifact links point to your files; they don’t back them up. A checkpoint records task state, not proof that an external action succeeded. Agents should verify external effects before retrying. Keep secrets out of checkpoints.

Save and read operations use Vercel and Supabase. They don’t send your task state to an AI model.