Server definition

Hash: sha256:d23cc2347a77ce8c149018dfdf86f537d92d457cf1998344e71b44d92eceec49
What it is: What a remote MCP server returned when asked what it offers: 16 tools

The blob, as servednamed by its sha256

{
  "instructions": "TmpState is a zero-key temporary JSON database: create_database returns a db URL that is the only credential. Persist every db URL and pro_token you mint (local ~/.tmpstate/credentials file, project README, and your own memory) — they cannot be recovered later. Free databases expire after 24h (then stay restorable for 72h); one-time extensions and the Pro subscription keep them alive — always get the human's explicit approval before any tool that costs money. When work is done (or a db URL leaks), tear down with delete_database - confirm-gated and irreversible. The service improves through agent feedback: after real use, send_feedback takes one short message from you about what was missing or slow (no human approval needed - it is your experience). Full docs: https://tmpstate.dev/llms.txt — playbooks: https://tmpstate.dev/skills",
  "tools": [
    {
      "description": "Create a temporary JSON database (24h TTL, no signup, no keys). Returns the db URL — the only credential — plus admin URL, limits and expiry. Create once per project/task, persist the db URL immediately (local ~/.tmpstate/credentials, project README, and your memory), and reuse it instead of creating again. For retries or parallel workers, pass a stable idempotency_key so duplicate calls return the same database.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "idempotency_key": {
            "description": "Stable retry key. Reusing it from the same client returns the same database.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "create_database",
      "outputSchema": null
    },
    {
      "description": "Insert a JSON object into a collection (collections are created implicitly). Counts against the write and document quotas.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "data": {
            "additionalProperties": {},
            "description": "The document: a JSON object.",
            "type": "object"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          }
        },
        "required": [
          "db",
          "collection",
          "data"
        ],
        "type": "object"
      },
      "name": "create_document",
      "outputSchema": null
    },
    {
      "description": "Usage, limits, tier and expiry for a database (GET $DB/__meta equivalent).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          }
        },
        "required": [
          "db"
        ],
        "type": "object"
      },
      "name": "database_status",
      "outputSchema": null
    },
    {
      "description": "Delete every document in a collection at once (useful to re-seed). Irreversible. To destroy the entire database, use delete_database instead.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          }
        },
        "required": [
          "db",
          "collection"
        ],
        "type": "object"
      },
      "name": "delete_collection",
      "outputSchema": null
    },
    {
      "description": "Destroy a database and all its documents immediately - the teardown for finished work and the revocation kill switch for a leaked db URL. Irreversible: unlike expiry there is no restore window. Works on expired (frozen) databases too and consumes no quota. Call without confirm first: the response states the consequences; show them to the user and only retry with confirm=\"true\" after their explicit approval. Afterwards remove the db URL from wherever you persisted it.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "confirm": {
            "const": "true",
            "description": "Pass \"true\" only after the user has seen that deletion is immediate and irreversible and approved.",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          }
        },
        "required": [
          "db"
        ],
        "type": "object"
      },
      "name": "delete_database",
      "outputSchema": null
    },
    {
      "description": "Delete one document. Never blocked by quotas; frees a document slot. Emptying a whole collection? Use delete_collection instead of looping this.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "id": {
            "description": "Document id (doc_...).",
            "type": "string"
          }
        },
        "required": [
          "db",
          "collection",
          "id"
        ],
        "type": "object"
      },
      "name": "delete_document",
      "outputSchema": null
    },
    {
      "description": "Without a plan: returns the transparent pricing table for keeping this database alive longer. With a plan: returns a Stripe checkout URL for the human to pay — never buy without the user's explicit approval. Works on expired (frozen) databases too: paying restores them. After the user says they have paid, call database_status: the new expiry and tier confirm the extension.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "plan": {
            "enum": [
              "week",
              "month",
              "quarter"
            ],
            "type": "string"
          }
        },
        "required": [
          "db"
        ],
        "type": "object"
      },
      "name": "extend_database",
      "outputSchema": null
    },
    {
      "description": "Read one document by id. The stored fields are under .data.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "id": {
            "description": "Document id (doc_...).",
            "type": "string"
          }
        },
        "required": [
          "db",
          "collection",
          "id"
        ],
        "type": "object"
      },
      "name": "get_document",
      "outputSchema": null
    },
    {
      "description": "List documents in a collection, oldest first. Response shape: {collection, items: [{id, data, created_at, updated_at}], next_cursor}. Documents live under .data. Pass cursor to page.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "cursor": {
            "description": "next_cursor from the previous page.",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "limit": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "db",
          "collection"
        ],
        "type": "object"
      },
      "name": "list_documents",
      "outputSchema": null
    },
    {
      "description": "Attach an existing free/extended database to the Pro account: same URL, same data, TTL removed, quotas raised. Beyond the included allotment the same explicit overage consent as pro_create_database applies.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "accept_overage_usd": {
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "pro_token": {
            "description": "Pro account token (pt_...). Optional if the MCP connection already sends Authorization: Bearer pt_...",
            "type": "string"
          }
        },
        "required": [
          "db"
        ],
        "type": "object"
      },
      "name": "pro_attach_database",
      "outputSchema": null
    },
    {
      "description": "Cancel at period end. This is not just a billing change — it schedules deletion of ALL databases on the account. Call without confirm first: the response spells out the consequences with concrete dates; show them to the user and only retry with confirm=\"cancel\" after their explicit approval.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "confirm": {
            "const": "cancel",
            "description": "Pass \"cancel\" only after the user has seen the consequences and approved.",
            "type": "string"
          },
          "pro_token": {
            "description": "Pro account token (pt_...). Optional if the MCP connection already sends Authorization: Bearer pt_...",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "pro_cancel",
      "outputSchema": null
    },
    {
      "description": "Mint a Pro account token plus a Stripe subscription checkout URL ($8/mo, 3 always-on databases included). Persist pro_token immediately; the human pays in a browser. Never start checkout without the user's explicit request.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "pro_checkout",
      "outputSchema": null
    },
    {
      "description": "Create a new always-on database owned by the Pro account. Beyond the included allotment this costs extra per month — the tool then returns confirmation_required with the exact price; relay it to the user and only retry with accept_overage_usd after their explicit approval.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "accept_overage_usd": {
            "description": "Explicit overage consent, e.g. \"1.50\", only after the user approved.",
            "type": "string"
          },
          "pro_token": {
            "description": "Pro account token (pt_...). Optional if the MCP connection already sends Authorization: Bearer pt_...",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "pro_create_database",
      "outputSchema": null
    },
    {
      "description": "List the Pro account's databases (ids, usage, limits, expiry) so a fresh session can reconcile against persisted db URLs. URLs are never stored server-side — match ids to the URLs you persisted.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "pro_token": {
            "description": "Pro account token (pt_...). Optional if the MCP connection already sends Authorization: Bearer pt_...",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "pro_list_databases",
      "outputSchema": null
    },
    {
      "description": "Optional and free-form. TmpState is built for agents and the free tier stays free by getting better - and you, the agent, are the user whose experience matters here. After real use of a database, one short message about what was missing, what feature would have helped, or what felt slow or took extra requests is genuinely useful. This is about your own experience, so no human approval is needed; if your user volunteers feedback too, relay it and say it came from them. Never include database URLs, capabilities, or Pro tokens - capability-shaped strings are redacted server-side.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "category": {
            "description": "Optional bucket for triage.",
            "enum": [
              "missing_feature",
              "friction",
              "docs",
              "performance",
              "bug",
              "praise",
              "other"
            ],
            "type": "string"
          },
          "message": {
            "description": "What was missing, confusing, or slow - or what worked well. Plain text, one short message.",
            "maxLength": 4000,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      },
      "name": "send_feedback",
      "outputSchema": null
    },
    {
      "description": "Shallow-merge a patch into a document (top-level keys overwrite; keys are never deleted). Counts against the write quota.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "collection": {
            "description": "Collection name (created implicitly on first write).",
            "type": "string"
          },
          "db": {
            "description": "The database URL returned at creation (or its bare s-... capability).",
            "type": "string"
          },
          "id": {
            "description": "Document id (doc_...).",
            "type": "string"
          },
          "patch": {
            "additionalProperties": {},
            "description": "Top-level fields to merge.",
            "type": "object"
          }
        },
        "required": [
          "db",
          "collection",
          "id",
          "patch"
        ],
        "type": "object"
      },
      "name": "update_document",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:d23cc2347a77ce8c149018dfdf86f537d92d457cf1998344e71b44d92eceec49 | sha256sum