# TmpState

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 493 installs
- Author: tmpstate
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/tmpstate/TmpState
- Updated: 2026-07-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tmpstate

## What it 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.

## Requirements
- Remote server: `https://tmpstate--tmpstate.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http tmpstate https://tmpstate--tmpstate.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add tmpstate --url https://tmpstate--tmpstate.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tmpstate": {
            "url": "https://tmpstate--tmpstate.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tmpstate": {
            "type": "http",
            "url": "https://tmpstate--tmpstate.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http tmpstate https://tmpstate--tmpstate.run.tools
```

## When to use it
- 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
- 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://...`.

## Similar
- [memory-vault](https://affpapa.org/en/nevibecode/mcp/ndpsoftware-memory-vault.md) — MCP server · 121 installs
- [appwrite-python](https://affpapa.org/en/nevibecode/skills/appwrite-python.md) — skill · 1100 installs
- [Supabase Developer](https://affpapa.org/en/nevibecode/skills/supabase-developer.md) — skill · 187 installs
- [supabase-skills](https://affpapa.org/en/nevibecode/plugins/supabase-skills.md) — plugin · ★ 1216 repo stars
- [storage-format](https://affpapa.org/en/nevibecode/skills/storage-format.md) — skill · 1300 installs
- [tsql-functions](https://affpapa.org/en/nevibecode/skills/tsql-functions.md) — skill · 187 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
