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
claude mcp add --transport http tmpstate https://tmpstate--tmpstate.run.toolsWhat 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.toolsPlatform CLI: remote server
codex mcp add tmpstate --url https://tmpstate--tmpstate.run.toolsConfig file
{
"mcpServers": {
"tmpstate": {
"url": "https://tmpstate--tmpstate.run.tools"
}
}
}Config file
{
"servers": {
"tmpstate": {
"type": "http",
"url": "https://tmpstate--tmpstate.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http tmpstate https://tmpstate--tmpstate.run.toolsStep 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.