Skip to main content
MCP server CX Codex

TmpState — Claude Code MCP server: what it does, how to install

TmpState is an MCP server for Claude Code and other coding agents that stores structured JSON state across steps and expires records automatically.

no license 493 installs updated 2026-07-05

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http tmpstate https://tmpstate--tmpstate.run.tools
Open on GitHub

What TmpState does

The server connects over HTTP to https://tmpstate--tmpstate.run.tools without API tokens. It equips agents with tools to spin up disposable databases, read records by ID, run shallow-merge updates, and fetch paginated lists. New collections initialize automatically as soon as the first object lands.

Free instances operate on a 24-hour lifespan. Because the service never keeps database URLs on its side, the full URL acts as the sole credential: if you lose that link, access is gone for good. Paid extensions keep a store alive for $1 per week, or via an $8 monthly Pro plan.

Canceling Pro via pro_cancel goes beyond stopping renewal payments: it marks every database on that account for permanent deletion once the billing term ends.

What it helps with

  • store agent state between execution runs without spinning up a local DBMS
  • spin up an ad-hoc 24-hour JSON datastore without signup or access keys
  • patch document attributes via top-level key merging
  • wipe an entire collection at once to re-seed demo data

Example prompts for the agent

  • Create a fresh TmpState database and output the generated URL.
  • Insert this configuration payload into the settings collection of database https://....
  • Check the status, current tier, and expiration timestamp for database https://....

How to install TmpState

Platform CLI: remote server

claude mcp add --transport http tmpstate https://tmpstate--tmpstate.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about TmpState

How to install TmpState in Claude Code?

Run claude mcp add --transport http tmpstate https://tmpstate--tmpstate.run.tools in your terminal. It hooks into the client over HTTP without requiring an API key.

What does TmpState do?

It gives your assistant tools to provision temporary JSON databases, insert documents, perform patches, and manage data lifecycles.

Where are database credentials stored?

The service does not keep database URLs on the backend. The URL returned during creation is the only access credential, so the agent must save it locally immediately.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open