The Upstash MCP connector routes your AI agent's tool calls to Upstash's own MCP server through Scalekit. Each user signs in to Upstash once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 77 tools.
- Tools
- 77
- What they doRead · write · destructive
- 28 · 9 · 4028 read9 write40 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Upstash MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Upstash MCP connection
In AgentKit > Connections, create an Upstash MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Upstash MCP server connections use your own OAuth app. Register one with Upstash MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Upstash MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'upstashmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Upstash MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'upstashmcp_qstash_list_users',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "upstashmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Upstash MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="upstashmcp_qstash_list_users",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolupstashmcp_blob_download_urlMints short-lived presigned GET URLs for objects in a Blob bucket, so their bytes are downloaded straight from storage — a `curl` inside a box, a browser — without passing through this server.Read-onlyGet Blob Download URL
Mints short-lived presigned GET URLs for objects in a Blob bucket, so their bytes are downloaded straight from storage — a `curl` inside a box, a browser — without passing through this server. This is the way to read a **private** bucket, whose objects have no public link; on a public bucket the permanent `public_url` works too and is returned alongside. The URLs only read, so they are available on read-only connections. A URL lives at most 10 minutes; set `download_as` to have storage serve the object as an attachment with that filename. A missing object is a 404 from storage when the URL is fetched, not an error here.
Inputs
bucket_idstringrequired- The bucket's id, from blob_bucket list or create
filesarrayrequired- The objects to mint download URLs for, one entry each
expires_ininteger- How long the URLs live, in seconds (default and maximum 600, the lifetime of the credential that signs them)
upstashmcp_box_accountAccount-wide views across every box.Read-onlyGet Box Account
Account-wide views across every box. Actions: summary (each active box with its cost; status deleted lists the deleted ones instead), billing (this month's token and compute totals), logs (log lines from all boxes; limit, offset, level, source, search, start_time and end_time filter them).
Inputs
actionstringrequired- The action to performone of
summarybillinglogs end_timeinteger- Unix seconds
levelstring- No description.one of
infowarnerror limitinteger- No description.
offsetinteger- No description.
searchstring- No description.
sourcestring- No description.
start_timeinteger- Unix seconds
statusstring- Which boxes to summarise (summary, default: active)one of
activedeleted
upstashmcp_box_logsReads a box's timestamped log entries — system, user and agent sources — which is how to find out what happened inside it.Read-onlyGet Box Logs
Reads a box's timestamped log entries — system, user and agent sources — which is how to find out what happened inside it. Filterable by source, level, free-text search and a timestamp window.
Inputs
box_idstringrequired- The box ID (its name works too)
end_timeinteger- Only entries at or before this Unix timestamp (seconds)
levelstring- Only entries at this levelone of
infowarnerror limitinteger- Maximum entries to return (max 1000, default 100)
offsetinteger- Entries to skip, for paging (default 0)
searchstring- Only entries whose message matches this text
sourcestring- Only entries from this sourceone of
systemuseragent start_timeinteger- Only entries at or after this Unix timestamp (seconds)
upstashmcp_box_metricsResource and token usage for a box.Read-onlyGet Box Metrics
Resource and token usage for a box. Actions: current (CPU, memory and disk right now), history (a time series; range such as 1h or 24h, step such as 1m), tokens (token counts and cost over the last days), steps (the agent's commits, one per prompt, newest first), step_diff (needs sha; the diff one step made).
Inputs
actionstringrequired- The action to performone of
currenthistorytokensstepsstep_diff box_idstringrequired- The box ID (its name works too)
daysinteger- Days of token usage to cover
rangestring- Time span for history, e.g. 1h, 24h, 7d
shastring- Step commit (step_diff)
stepstring- Resolution for history, e.g. 1m, 5m, 1h
upstashmcp_console_redis_keysConsole only: one SCAN page of a Redis database with each key's type and TTL.Read-onlyList Redis Keys (Console)
Console only: one SCAN page of a Redis database with each key's type and TTL.
Inputs
databaseIdstringrequired- The Redis database ID
countinteger- No description.default
100 cursorstring- No description.default
0 matchstring- No description.
typestring- Only keys of this type (SCAN's TYPE option)one of
stringhashlistsetzsetstreamjson
upstashmcp_console_redis_valueConsole only: one Redis key's type, TTL, size and a bounded read of its value.Read-onlyRead Redis Value (Console)
Console only: one Redis key's type, TTL, size and a bounded read of its value.
Inputs
databaseIdstringrequired- The Redis database ID
keystringrequired- No description.
upstashmcp_dlq_listLists the dead-letter queue for QStash messages or Workflow runs (service picks which).Read-onlyList Dead Letter Queue
Lists the dead-letter queue for QStash messages or Workflow runs (service picks which). Paginated via cursor.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus servicestringrequired- Which service the operation targets: plain QStash messaging or Upstash Workflowone of
qstashworkflow cursorstring- No description.
upstashmcp_index_fetchFetches documents by ID.Read-onlyFetch Index Documents
Fetches documents by ID. Payload e.g. {"ids":["a","b"],"includeMetadata":true}, or {"prefix":"doc-","includeMetadata":true} to match an ID prefix.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON fetch payload
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch namespacestring- Vector: the namespace (omit for the default one). Search: the named index, which is required — list them with index_list_namespaces
upstashmcp_index_getGets details of one Vector index or Search database (endpoint, models, limits, usage).Read-onlyGet Index
Gets details of one Vector index or Search database (endpoint, models, limits, usage). Its REST tokens are included only when include_credentials is true and the connection is read-write; on a read-only connection they are omitted (get them from the Upstash console).
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
upstashmcp_index_get_statsGets usage statistics of one Vector index or Search database: queries and updates today and this month, storage, bandwidth and cost this month, queries and updates per day, throughput and latency (mean and p99) over the period, and document count and data size over time.Read-onlyGet Index Usage Stats
Gets usage statistics of one Vector index or Search database: queries and updates today and this month, storage, bandwidth and cost this month, queries and updates per day, throughput and latency (mean and p99) over the period, and document count and data size over time. Search databases add rerank and input-enrichment figures.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch periodstring- Window the time series cover; the API's default when omitted. Daily and monthly totals ignore itone of
1h3h12h1d3d7d
upstashmcp_index_infoGets runtime info: total and pending document counts, index size, and a per-namespace breakdown.Read-onlyGet Index Info
Gets runtime info: total and pending document counts, index size, and a per-namespace breakdown. For Search those namespaces are its named indexes, with their document counts.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_listLists the Upstash Vector indexes or Search databases in the authorized account scope.Read-onlyList Indexes
Lists the Upstash Vector indexes or Search databases in the authorized account scope. Never includes tokens — call index_get with include_credentials for one of them.
Inputs
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_list_namespacesLists the namespaces of a Vector index — or, for a Search database, its named indexes, which are the same thing.Read-onlyList Index Namespaces
Lists the namespaces of a Vector index — or, for a Search database, its named indexes, which are the same thing. This is what search.listIndexes() calls.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_rangeIterates through the documents of a namespace, a page at a time.Read-onlyRange Over Index Documents
Iterates through the documents of a namespace, a page at a time. Payload e.g. {"cursor":"0","limit":100,"includeMetadata":true}; reuse the returned cursor for the next page, and stop to ask the user if the results get large.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON range payload
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch namespacestring- Vector: the namespace (omit for the default one). Search: the named index, which is required — list them with index_list_namespaces
upstashmcp_logs_listLists delivery/run logs for QStash messages or Workflow runs (service picks which), newest first.Read-onlyList Logs
Lists delivery/run logs for QStash messages or Workflow runs (service picks which), newest first. Paginated via cursor. This is the way to inspect a Workflow run by ID, whether it has finished or is still running: pass service workflow and workflowRunId, and the entry holds the run's state, its steps and their error bodies, in one call. workflowRunId, workflowUrl, state, workflowCreatedAt and label filter Workflow runs and are refused for service qstash; count works for both. QStash and Workflow only: Upstash keeps no command or request log for Redis databases (only the Enterprise audit-log add-on records commands, and it is not exposed here), and SLOWLOG and ACL LOG are not available on them. For Redis activity use redis_get_stats, and redis_get_insights or redis_get_traffic when the database has Prod Pack or a Pro plan.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus servicestringrequired- Which service the operation targets: plain QStash messaging or Upstash Workflowone of
qstashworkflow countinteger- Maximum number of entries (Workflow: runs) to return
cursorstring- Pagination cursor from a previous call
labelstring- Workflow only: runs triggered with this label
statestring- Workflow only: runs that reached this state. Every run has reached RUN_STARTED, so it matches all runs; runs still in progress are the ones whose workflowState is RUN_STARTED in the result.one of
RUN_STARTEDRUN_SUCCESSRUN_FAILEDRUN_CANCELED workflowCreatedAtinteger- Workflow only: the run's creation time in Unix milliseconds, as its workflowRunCreatedAt field shows
workflowRunIdstring- Workflow only: return just this run. IDs start with wfr_ (a custom ID my-run-1 is stored as wfr_my-run-1). Several runs can share an ID; workflowCreatedAt picks one.
workflowUrlstring- Workflow only: runs of this workflow endpoint URL (exact match)
upstashmcp_qstash_flow_control_getGets flow-control state: rate/parallelism info for a flow-control key, or the account's global parallelism when key is omitted.Read-onlyGet QStash Flow Control
Gets flow-control state: rate/parallelism info for a flow-control key, or the account's global parallelism when key is omitted.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus keystring- Flow-control key (omit for global parallelism)
upstashmcp_qstash_get_statsGets usage statistics of a region's QStash user, which QStash and Workflow share.Read-onlyGet QStash Usage Stats
Gets usage statistics of a region's QStash user, which QStash and Workflow share. daily_requests has one point per day of the current month (y: QStash messages, workflow_message: the Workflow share of them, workflow_run: Workflow runs), as do daily_billings (cost) and daily_bandwidths; days still to come in the month are zeros. daily_qstash_messages (delivered, failed, retry, error, canceled, total) and daily_workflow_messages (success, failed, canceled, total) are today's running counts by outcome, sampled across `period` and reset at 00:00 UTC, so their last point is today so far. Also global parallelism over the period and the DLQ size. `service` keeps only one side's outcome series. With refresh, the API recomputes the cached figures first.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus periodstring- Window the time series cover; the API's default when omitted. Daily and monthly totals ignore itone of
1h3h12h1d3d7d refreshboolean- Ask the API to recompute the cached figures before reading them, as the Upstash console does when it opens the page. Needs a read-write connection; when the refresh is refused the cached figures are still returned, with refreshed: false
servicestring- Keep only QStash's or only Workflow's message series (default: both)one of
qstashworkflow
upstashmcp_qstash_list_schedulesLists QStash schedules in a region.Read-onlyList QStash Schedules
Lists QStash schedules in a region.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus
upstashmcp_qstash_list_usersLists the QStash users in the authorized account scope, one per region.Read-onlyList QStash Users
Lists the QStash users in the authorized account scope, one per region. Each region's REST tokens, and with `region` ("eu" or "us") that region's request signing keys ({ current, next }, fetched live), are included only when include_credentials is true and the connection is read-write; on a read-only connection they are omitted. The REST base URL for a region is https://qstash-<region>.upstash.io (e.g. qstash-us-east-1.upstash.io).
Inputs
include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
regionstring- Return only this region's user (with its request signing keys when include_credentials is true)one of
euus
upstashmcp_redis_get_databaseGets details of a single Upstash Redis database: endpoint, region, plan, limits and state.Read-onlyGet Redis Database
Gets details of a single Upstash Redis database: endpoint, region, plan, limits and state. Credentials (password and REST tokens) are included only when include_credentials is true and the connection is read-write; on a read-only connection they are omitted (get them from the Upstash console). A database with Protect Credentials enabled (is_password_protected) has none to return. A branch has root_database_id (the database it belongs to) and source_database_id (the database or branch it was copied from, which may since have been deleted), and can only be looked up by its ID.
Inputs
databaseIdstringrequired- The Redis database ID
include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
upstashmcp_redis_get_insightsGets the Redis Insights series of a database, as the Upstash console's Insights tab shows them: latency percentiles (overall, read, write, command, Lua, replication, wait), throughput, bandwidth, disk, expired entries and replication lag, for the whole database and per region (or one replica).Read-onlyGet Redis Insights
Gets the Redis Insights series of a database, as the Upstash console's Insights tab shows them: latency percentiles (overall, read, write, command, Lua, replication, wait), throughput, bandwidth, disk, expired entries and replication lag, for the whole database and per region (or one replica). Also counters over the period (throttled commands, auth failures, over-size requests, undeliverable messages, Lua executions, failures, timeouts and memory-limit hits, REST commands, connections opened), each metric's mean now against the window before, and anomalies the backend detected (start, peak, baseline and change, heaviest first). Start with anomalies and counters when asked why a database is slow or failing. `metrics` trims the per-metric series, which are most of the response. Needs Prod Pack (or a Pro or Enterprise plan): without it the API answers 404 "insights require Prod Pack"; redis_set_prod_pack turns it on.
Inputs
databaseIdstringrequired- The Redis database ID
metricsarray- Return only these metrics' series, comparisons and anomalies (default: all)
periodstring- Window the series and counters cover (default 1d)one of
1h3h12h1d3d7d30d replicastring- Narrow the series to one replica (a group key from `groups`); default: the whole database, per region
upstashmcp_redis_get_statsGets usage statistics of an Upstash Redis database: throughput, latency, hits and misses, keys, data size and connections over the period, requests per day, and this month's requests, bandwidth and cost.Read-onlyGet Redis Usage Stats
Gets usage statistics of an Upstash Redis database: throughput, latency, hits and misses, keys, data size and connections over the period, requests per day, and this month's requests, bandwidth and cost. With refresh, the API recomputes the cached figures first. Commands reach these figures about two minutes after they run, and refresh does not shorten that; it only brings dailyrequests and the monthly totals up to what has been collected. So for a database created or used in the last few minutes, a count of 0 means not counted yet, not no traffic: tell the user the numbers trail by a couple of minutes and offer to check again, rather than reporting 0.
Inputs
databaseIdstringrequired- The Redis database ID
periodstring- Window the time series cover; the API's default when omitted. Daily and monthly totals ignore itone of
1h3h12h1d3d7d refreshboolean- Ask the API to recompute the cached figures before reading them, as the Upstash console does when it opens the page. Needs a read-write connection; when the refresh is refused the cached figures are still returned, with refreshed: false
upstashmcp_redis_get_trafficGets where a Redis database's traffic comes from and how it is served: the client networks the proxies sampled (masked prefixes, cloud provider and region, share), the SDKs, platforms and runtimes clients report with their retry rate, routes from entry region to serving region with requests, connections, bytes, errors and whether they cross regions, the entry regions by share, the cross-region share of bytes, and REST vs.Read-onlyGet Redis Traffic
Gets where a Redis database's traffic comes from and how it is served: the client networks the proxies sampled (masked prefixes, cloud provider and region, share), the SDKs, platforms and runtimes clients report with their retry rate, routes from entry region to serving region with requests, connections, bytes, errors and whether they cross regions, the entry regions by share, the cross-region share of bytes, and REST vs. Lua command counts. Use it to find clients far from the database, or traffic served cross-region. Needs Prod Pack (or a Pro or Enterprise plan): without it the API answers 404 "insights require Prod Pack"; redis_set_prod_pack turns it on.
Inputs
databaseIdstringrequired- The Redis database ID
periodstring- Window the series and counters cover (default 1d)one of
1h3h12h1d3d7d30d
upstashmcp_redis_list_backupsLists backups of an Upstash Redis database.Read-onlyList Redis Backups
Lists backups of an Upstash Redis database.
Inputs
databaseIdstringrequired- The Redis database ID
upstashmcp_redis_list_databasesLists all Upstash Redis databases in the authorized account scope.Read-onlyList Redis Databases
Lists all Upstash Redis databases in the authorized account scope. Never includes credentials — call redis_get_database with include_credentials for one database's. Branches are listed too: root_database_id is set on a branch and names the database it belongs to, so filter on it to find a database's branches.
Inputs
This tool takes no inputs.
upstashmcp_search_queryRuns a full-text and semantic search over one named index of a Search database.Read-onlySearch Documents
Runs a full-text and semantic search over one named index of a Search database. No tokens needed. Payload per the Search REST API, e.g. {"query":"space odyssey","limit":5,"reranking":true}.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
indexNamestringrequired- The named index inside the Search database
payloadstringrequired- JSON search payload
upstashmcp_upstash_consoleOpens the Upstash console: an interactive view of the user's Redis databases and keys, QStash and Workflow schedules, logs and DLQs, Vector and Search indexes, Boxes and Blob buckets.Read-onlyOpen Upstash Console
Opens the Upstash console: an interactive view of the user's Redis databases and keys, QStash and Workflow schedules, logs and DLQs, Vector and Search indexes, Boxes and Blob buckets. Call it when the user asks to see, browse or open their Upstash resources rather than for a specific answer. To show one resource, pass product and resource (and a tab): the console opens on it, and the user can still navigate from there.
Inputs
productstring- Open on this product's page instead of the first oneone of
redisqstashworkflowvectorsearchboxblob resourcestring- Select this resource, by ID or name: a Redis database, Vector index, Search database, box or Blob bucket. For QStash and Workflow, the region: eu or us
tabstring- Open this tab: overview and stats (every product); settings (every product: a Danger zone with deleting the resource and, except Box, resetting its credentials; Redis, QStash, Workflow, Vector, Search also plan, Prod Pack and budget, and Redis read regions, eviction and auto-upgrade); data, cli, insights (Redis); data (Vector, Search); publish, schedules, logs, dlq (QStash); trigger, runs, dlq (Workflow); logs, snapshots (Box); objects (Blob)one of
overviewdataclistatsinsightspublishtriggerscheduleslogsrunsdlqobjectssnapshotssettings
upstashmcp_vector_queryQueries a Vector index by vector similarity.Read-onlyQuery Vectors
Queries a Vector index by vector similarity. No tokens needed. Payload per the Vector REST API, e.g. {"vector":[...],"topK":10,"includeMetadata":true} — or with useData=true, {"data":"text to embed","topK":10} for embedding-model indexes. For a Search database use search_query instead.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON payload as the Vector REST API expects
namespacestring- Namespace to query (omit for the default namespace)
useDataboolean- true = /query-data (server-side embedding)
upstashmcp_blob_upload_urlMints presigned PUT URLs for paths in a Blob bucket, so files are uploaded straight to storage from wherever they already are — a `curl` inside a box, a CI job — without their bytes passing through this server.WriteGet Blob Upload URL
Mints presigned PUT URLs for paths in a Blob bucket, so files are uploaded straight to storage from wherever they already are — a `curl` inside a box, a CI job — without their bytes passing through this server. Send the returned `headers` verbatim with the PUT: they are part of the signature, so a changed, dropped or added header is a 403 from storage. A URL lives at most 10 minutes, so mint it immediately before uploading rather than up front. On a public bucket each file also comes back with `public_url`, the permanent link to use once the upload succeeds (in a PR body, say); a private bucket has none. The result's `curl_example` is the first file's real command line.
Inputs
bucket_idstringrequired- The bucket's id, from blob_bucket list or create
filesarrayrequired- The files to mint upload URLs for, one entry each
expires_ininteger- How long the URLs live, in seconds (default and maximum 600, the lifetime of the credential that signs them)
upstashmcp_box_browserDrives the headless Chromium in a box created with browser=true.WriteControl Box Browser
Drives the headless Chromium in a box created with browser=true. Actions: goto (navigate to url and return the page), content (read the current page as title/url/text/links), screenshot (PNG of the page — returned as an image unless path is given, in which case it is saved into the box at that path instead), tabs (list the open tabs), tab_new (open a tab, optionally at url), tab_close (needs tab), live_view (a view-only page a person can open to watch the tab live — frames flow out, no input goes in, so hand the URL to the user rather than trying to click in it). box_id is required for every action.
Inputs
actionstringrequired- The action to performone of
gotocontentscreenshottabstab_newtab_closelive_view box_idstringrequired- The box ID (its name works too)
full_pageboolean- Capture the whole scrollable page rather than the viewport (screenshot)
pathstring- Save the screenshot at this path inside the box instead of returning the image (screenshot)
tabstring- CDP target id of the tab, from the tabs action (required for tab_close; elsewhere the active tab is used when omitted)
urlstring- URL to open (required for goto, optional for tab_new)
upstashmcp_index_createCreates a Vector index or a Search database and returns it.WriteCreate Index
Creates a Vector index or a Search database and returns it. Its REST tokens are included only when include_credentials is true — set it when the user is going to configure an app with it; they can also be fetched later with index_get. Search takes only name, region and plan — its embedding, reranking and enrichment models are fixed by the service, and its named indexes are created implicitly by the first search_upsert. Vector takes the rest: dimensions come from the embedding model when one is given, so pass dimensionCount only for an index you will supply your own vectors to; a SPARSE index takes neither and is described by sparseEmbeddingModel alone; a HYBRID index takes both models or neither. Plans and prices (Search is billed as Vector): https://upstash.com/pricing/vector.md; when the user picks fixed, confirm its monthly price with them first.
Inputs
namestringrequired- Index or database name
regionstringrequired- Region to create in. Vector: an AWS or GCP region such as us-east-1 or eu-west-1 (the API rejects one it has no pool for). Search: only us-central1 or eu-west-1
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch dimensionCountinteger- Vector only. Required for a DENSE index with no embedding model; derived from the model otherwise, and rejected for SPARSE
embeddingModelstring- Vector only. Upstash-hosted dense embedding model, so you can upsert text instead of vectors. Sets dimensionCountone of
BGE_SMALL_EN_V1_5BGE_BASE_EN_V1_5BGE_LARGE_EN_V1_5BGE_M3TEXT_EMBEDDING_3_SMALL include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
indexTypestring- Vector only. Index type (default DENSE)one of
DENSESPARSEHYBRID planstring- Plan (default: free for accounts without a payment method, payg otherwise)one of
freepaygfixedpro similarityFunctionstring- Vector only. Similarity function (default EUCLIDEAN). Not applicable to SPARSEone of
COSINEEUCLIDEANDOT_PRODUCT sparseEmbeddingModelstring- Vector only. Sparse embedding model, for SPARSE and HYBRID indexesone of
BGE_M3BM25
upstashmcp_qstash_publish_messagePublishes a message to a destination URL via QStash.WritePublish QStash Message
Publishes a message to a destination URL via QStash. No tokens needed — the region's QStash token is resolved server-side.
Inputs
destinationUrlstringrequired- The URL QStash should deliver the message to
regionstringrequired- QStash region of your QStash userone of
euus bodystring- Message body
contentTypestring- Content-Type of the body (default application/json)
delaySecondsinteger- Delivery delay in seconds
retriesinteger- Max retries on delivery failure
upstashmcp_redis_create_backupCreates a manual backup of an Upstash Redis database.WriteCreate Redis Backup
Creates a manual backup of an Upstash Redis database.
Inputs
databaseIdstringrequired- The Redis database ID
namestringrequired- Name for the backup
upstashmcp_redis_create_branchCreates a branch of an Upstash Redis database: a point-in-time copy of its data with its own endpoint and password, for testing against real data.WriteCreate Redis Branch
Creates a branch of an Upstash Redis database: a point-in-time copy of its data with its own endpoint and password, for testing against real data. Later changes on either side stay separate, and a branch cannot be merged back. It returns right away with state "creating": poll redis_get_database with the returned database_id until state is "active" before using it, which usually takes seconds. If that lookup starts returning 404, creation failed and the branch was removed. A branch has a single replica and no read regions, and is billed as pay-as-you-go for its requests, storage and bandwidth whatever the source's plan (https://upstash.com/pricing/redis.md), so tell the user before copying a large database. Needs an account with a payment method and a global source database on a pay-as-you-go, fixed or enterprise plan; free, legacy Pro, IP-allowlisted, HIPAA, ephemeral, suspended and busy databases are refused. A branch can itself be branched. Use redis_delete_database to delete a branch and redis_rename_database to rename one.
Inputs
databaseIdstringrequired- The ID of the database or branch to copy
namestringrequired- Branch name, up to 100 characters: letters, numbers, hyphens, underscores and dots, starting and ending with a letter or number. Unique among the branches of one database
include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
upstashmcp_redis_create_databaseCreates a new Upstash Redis database and returns it.WriteCreate Redis Database
Creates a new Upstash Redis database and returns it. Its credentials (password and REST tokens) are included only when include_credentials is true — set it when the user is going to configure an app with the new database; they can also be fetched later with redis_get_database. Without plan the database is free or pay-as-you-go, depending on whether the account has a payment method. Plans and prices: https://upstash.com/pricing/redis.md; when the user picks a fixed tier, confirm its monthly price with them first.
Inputs
namestringrequired- Database name (alphanumeric)
primaryRegionstringrequired- Primary region, e.g. us-east-1, eu-west-1
include_credentialsboolean- Set true only when the user asks for connection details or wants to configure an app with this resource: the result then includes its credentials (REST tokens, password). Default false — metadata only. On a read-only connection credentials are omitted regardless
planstring- Plan to create the database on. On the pricing page "Pay as You Go" is payg and "Fixed 250MB" … "Fixed 500GB" are fixed_250mb … fixed_500gbone of
freepaygfixed_250mbfixed_1gbfixed_5gbfixed_10gbfixed_50gbfixed_100gbfixed_500gb readRegionsarray- Optional read-replica regions
upstashmcp_redis_set_daily_backupTurns automatic daily backups of an Upstash Redis database on or off.WriteSet Redis Daily Backup
Turns automatic daily backups of an Upstash Redis database on or off. The first backup runs about 24 hours after turning them on; redis_list_backups lists them and redis_get_database shows daily_backup_enabled and next_daily_backup_time. Free databases cannot use backups, nor can suspended ones, databases managed through Fly, Heroku or DigitalOcean, or databases where support has disabled backups; the Finance team role cannot change it. Prod Pack includes daily backups, so they cannot be turned off while Prod Pack is on; HIPAA databases cannot turn them off either. Nothing is sent when backups are already in the requested state.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
enabledbooleanrequired- true to turn daily backups on, false to turn them off
upstashmcp_submit_feedback_to_upstash_teamReport friction with this MCP server to the Upstash team that builds it.WriteSend Feedback to the Upstash Team
Report friction with this MCP server to the Upstash team that builds it. Use it when: - no tool could do what the user asked - a tool failed, returned wrong data, or was confusing - you have an idea that would make the tools better Call it at most once per task, after you finish or give up. The feedback goes to the Upstash team, not to the user's account. Do not include secrets, credentials, database contents or personal data. Example: task 'find the slowest Redis commands', kind 'missing', impact 'worked_around', description 'redis_get_insights has latency percentiles but no per-command breakdown; I ran SLOWLOG GET with redis_run_command.'
Inputs
descriptionstringrequired- What you tried, with the tool calls and any error, and what went wrong.
impactstringrequired- blocked: you could not finish; worked_around: you finished another way; friction: you finished, but it was harder than it should be.one of
blockedworked_aroundfriction kindstringrequired- missing: no tool could do it; broken: a tool failed or returned something wrong; confusing: a tool or its description was unclear; idea: a suggestion.one of
missingbrokenconfusingidea taskstringrequired- A short phrase naming what the user asked you to do.
tool_namestring- The tool of this server the feedback is about, if any.
upstashmcp_blob_bucketLists, gets, creates or deletes Upstash Blob buckets — object storage an agent can upload files to and link to afterwards.DestructiveManage Blob Buckets
Lists, gets, creates or deletes Upstash Blob buckets — object storage an agent can upload files to and link to afterwards. Blob has no plans to choose: storage, operations and bandwidth are free up to a monthly allowance and pay-as-you-go above it (https://upstash.com/pricing/blob.md). Actions: list (every bucket in the authorized account scope), get (needs bucket_id; with include_credentials the result also carries the bucket's `token`, the value `@upstash/blob` reads as UPSTASH_BLOB_TOKEN), stats (needs bucket_id; storage, bandwidth, operations and cost per day and per month, collected hourly, so today's row is partial), create (needs name), delete (needs bucket_id; permanent, and refused while the bucket still holds objects — empty it with blob_object delete first), reset_token (needs bucket_id; rotates the bucket token: the current token stops working at once, so apps need the new UPSTASH_BLOB_TOKEN from get with include_credentials; confirm with the user first). A public bucket serves its objects at a permanent URL under public_host, which is what you want for a link that has to keep working, such as an image embedded in a PR body; a private bucket has no public host and its objects are reachable only through short-lived signed URLs. The token is returned only by get with include_credentials on a read-write connection; on a read-only connection it is omitted regardless, and list, create, delete and reset_token never return it.
Inputs
actionstringrequired- The action to performone of
listgetstatscreatedeletereset_token bucket_idstring- The bucket's id, from blob_bucket list (required for get, stats, delete and reset_token)
daysinteger- stats only: daily rows to return, including today (max 90)
include_credentialsboolean- get only. Set true only when the user asks for the bucket's credentials or wants to configure an app with it (UPSTASH_BLOB_TOKEN): the result then includes `token`. Default false — metadata only. On a read-only connection the token is omitted regardless
monthsinteger- stats only: monthly rows to return, including this month (max 24)
namestring- Bucket name, unique within the account (required for create)
visibilitystring- Whether the bucket's objects are served publicly (create, default: public). Public gives every object a permanent URL; private objects are reachable only through short-lived signed URLsone of
publicprivate
upstashmcp_blob_objectLists or deletes objects in an Upstash Blob bucket — their paths, sizes and links, never their bytes.DestructiveManage Blob Objects
Lists or deletes objects in an Upstash Blob bucket — their paths, sizes and links, never their bytes. Actions: list (needs bucket_id; optional prefix and cursor; up to 1000 objects per page, and a cursor in the result means more follow — pass it back to continue), delete (needs bucket_id and paths, up to 1000 exact keys; permanent, and a path that is already gone counts as deleted). To empty a bucket before blob_bucket delete, list a page, delete its paths, repeat until list comes back empty. Never returns bucket tokens.
- Idempotent
Inputs
actionstringrequired- The action to performone of
listdelete bucket_idstringrequired- The bucket's id, from blob_bucket list or create
cursorstring- list only: where to continue from, as returned by the previous page
pathsarray- delete only: the exact object keys to remove (up to 1000)
prefixstring- list only: objects whose key starts with this, e.g. 'proof/my-repo/'
upstashmcp_box_apikeyManages Box API keys for the authorized account scope, the credential the Box SDK, CLI and deployed apps use.DestructiveManage Box API Keys
Manages Box API keys for the authorized account scope, the credential the Box SDK, CLI and deployed apps use. Actions: list (metadata only: id, name, prefix, never the secret), create (optional name; read_only: true makes a key that can read boxes, logs and files and run exec as a restricted user, gets 403 on every write, cannot wake a paused box and sees secrets masked, which suits monitoring or a debugging agent; returns the secret once, so surface it to the user to store), delete (needs api_key_id; anything still using the key stops working immediately). A key is account-scoped and independent of this connection: it keeps working after the OAuth grant that created it is revoked, so tell the user to delete it, here or in the Upstash console, once it is no longer needed. Read-only OAuth grants get 403 on create and delete.
Inputs
actionstringrequired- The action to performone of
listcreatedelete api_key_idstring- Key id from list (required for delete)
namestring- Display name for the key (create)
read_onlyboolean- Create a read-only key (create). Cannot be changed later
upstashmcp_box_configChanges a running box's configuration.DestructiveManage Box Config
Changes a running box's configuration. Actions: get (model, MCP servers and enabled skills; labels are on box_manage get); set_model (needs model); add_label and remove_label (need label); add_skill and remove_skill (need skill, as owner/repo/skill-name); add_mcp_server (needs mcp_server) and remove_mcp_server (needs name); set_network_policy (needs network_policy); set_git_identity (needs git_user_name and git_user_email); get_init_command, set_init_command (needs init_command) and delete_init_command, which apply to keep-alive boxes only. Size, browser and keep_alive are fixed at create time. Read-only OAuth connections are refused with 403 on the actions that write.
- Idempotent
Inputs
actionstringrequired- The action to performone of
getset_modeladd_labelremove_labeladd_skillremove_skilladd_mcp_serverremove_mcp_serverset_network_policyset_git_identityget_init_commandset_init_commanddelete_init_command box_idstringrequired- The box ID (its name works too)
git_user_emailstring- git user.email (set_git_identity)
git_user_namestring- git user.name (set_git_identity)
init_commandstring- Startup script (set_init_command)
labelstring- Label (add_label, remove_label)
mcp_serverobject- Server to add (add_mcp_server)
modelstring- Model identifier (set_model)
namestring- Server name (remove_mcp_server)
network_policyobject- Outbound policy; the lists apply to mode custom (set_network_policy)
skillstring- Skill id, owner/repo/skill-name (add_skill, remove_skill)
upstashmcp_box_envAccount-level environment variables, merged into every box created afterwards; a box's own env_vars win for the same key, and a box that already exists is not changed.DestructiveManage Box Environment
Account-level environment variables, merged into every box created afterwards; a box's own env_vars win for the same key, and a box that already exists is not changed. Actions: list (values come back masked), set (needs key and value), set_all (needs env_vars, and replaces the whole set), delete (needs key). Not a secrets store: a value set here is visible inside every future box. Read-only OAuth connections are refused with 403 on the actions that write.
- Idempotent
Inputs
actionstringrequired- The action to performone of
listsetset_alldelete env_varsobject- The full set (set_all)
keystring- Variable name (set, delete)
valuestring- Variable value (set)
upstashmcp_box_execRuns a shell command inside a box, waits for it to finish, and returns its exit code and output.DestructiveRun Command in Box
Runs a shell command inside a box, waits for it to finish, and returns its exit code and output. Use it for file operations, package installs, builds, tests — anything a shell does. For repository work (clone, commit, push, pull request) use box_git, which also puts the GitHub credentials into the box. The command is an argv array, e.g. ['bash', '-c', 'ls -la']; an inline program is one too: ['node', '-e', code], ['python3', '-c', code] or ['npx', 'tsx', '-e', code], and content written with ['sh', '-c', 'printf %s "$1" > "$2"', 'sh', content, path] needs no quoting. `folder` defaults to /workspace/home, the workspace root; a clone sits at /workspace/home/<repo name>. To start something long-running (a dev server, say) without blocking, detach it inside the shell: ['sh', '-c', '( my-server > server.log 2>&1 & )']. A paused box is resumed first. Read-only OAuth connections cannot run commands: the box API refuses them with 403.
Inputs
box_idstringrequired- The box ID (its name works too)
commandarrayrequired- Command and arguments as an array, e.g. ['bash', '-c', 'ls -la']
folderstring- Working directory inside the box (defaults to /workspace/home)
upstashmcp_box_gitRuns git inside a box.DestructiveRun Git in Box
Runs git inside a box. Authentication comes from the GitHub installation linked to the Upstash account — the tool takes no token, and a private repo works only if that installation can see it. Actions: clone (needs repo), status, diff, commit (needs message), checkout (needs branch), push, create_pr (needs title), create_issue (needs title). Anything else git does (add, log, rebase) is a box_exec command such as ['git', 'log', '-1']. Clone with this tool rather than with git in box_exec: clone is what puts the GitHub credentials into the box, and without them push and create_pr fail with a 500. A clone lands at /workspace/home/<repo name>; pass that as `folder` on every other action, since the default is the workspace root, which is not a repository. create_pr opens the pull request for the branch as it exists on the remote and pushes nothing itself, so push first, and give push the branch name: without one the API pushes to a branch named after the box. Read-only OAuth connections are refused with 403 on the actions that write (clone, commit, checkout, push, create_pr, create_issue).
Inputs
actionstringrequired- The action to performone of
clonestatusdiffcommitcheckoutpushcreate_prcreate_issue box_idstringrequired- The box ID (its name works too)
author_emailstring- Override the commit author email (commit)
author_namestring- Override the commit author name (commit)
basestring- Branch the pull request merges into (create_pr, defaults to the repo's)
bodystring- Description (create_pr, create_issue)
branchstring- Branch: to clone, to switch to (required for checkout), or to push
depthinteger- Clone depth; 0 or omitted clones the full history (clone)
folderstring- Working directory inside the box, normally the clone's folder such as /workspace/home/<repo name> (defaults to /workspace/home, which is not a repository). For clone: the directory name to clone into, relative to /workspace/home
messagestring- Commit message (required for commit)
repostring- Repository URL to clone, https/http/git/ssh (required for clone)
titlestring- Title (required for create_pr and create_issue)
upstashmcp_box_manageManages Upstash Boxes — sandboxed cloud containers with a shell, a filesystem and an optional headless browser.DestructiveManage Boxes
Manages Upstash Boxes — sandboxed cloud containers with a shell, a filesystem and an optional headless browser. Actions: create (set browser=true to make box_browser usable), list (optionally filtered by label or status), get, status (cheaper than get, for polling), delete (permanent, takes the workspace with it; pass box_id for one box or box_ids for several in one call), pause, resume, fork (copies an idle or paused non-ephemeral box), reset (wipes the workspace back to a fresh box; the id survives). Every action except create and list needs box_id (delete accepts box_ids instead). There is no delete-everything: to clear an account, list first and pass the ids you mean. Ephemeral boxes need no paid plan and are cleaned up when their TTL expires; keep-alive boxes require one. size and keep_alive set what a box costs and cannot be changed after create; prices per size: https://upstash.com/pricing/box.md. Confirm with the user before creating a keep-alive box, which is billed for as long as it exists, used or not.
Inputs
actionstringrequired- The action to performone of
createlistgetstatusdeletepauseresumeforkreset agentstring- Agent to install in the box (create, default: claude-code)one of
claude-codecodexopencodecursor attach_headersobject- Headers injected into outbound requests, keyed by host pattern, e.g. {'api.stripe.com': {'Authorization': 'Bearer ...'}} (create)
box_idstring- Box ID (required for get, status, pause, resume, fork, reset; delete takes this or box_ids)
box_idsarray- Several box IDs to delete in one call (delete only, at most 50); the result counts how many were deleted and how many failed
browserboolean- Give the box a headless Chromium (create). Without it box_browser fails with 'browser is not enabled for this box'
clone_repostring- Git repository URL to clone into the box on startup (create)
clone_tokenstring- Token for cloning a private repository (create)
env_varsobject- Environment variables to set inside the box (create)
ephemeralboolean- Create a throwaway box that is deleted when its TTL expires (create)
git_user_emailstring- git user.email inside the box (create)
git_user_namestring- git user.name inside the box (create)
init_commandstring- Startup script run when the box starts; keep-alive boxes only (create)
keep_aliveboolean- Keep the box running rather than idling it (create, requires a paid plan; mutually exclusive with ephemeral)
labelstring- Only return boxes carrying this label (list)
labelsarray- Labels to tag the box with (create)
mcp_serversarray- MCP servers for the box's agent, an npm package or a remote url each (create)
modelstring- LLM model the box's agent runs, e.g. 'claude/sonnet_4_6' or 'openai/o4-mini' (create). Agent runs use the provider key saved on the account in the Upstash Console; without one they fail, though the box still works for shell, files and git
namestring- Display name for the box (create)
network_policyobject- Outbound network policy; the lists apply to mode custom (create)
runtimestring- Runtime image, e.g. 'node' or 'python' (create, default: node)
sizestring- Box size (create, default: small)one of
smallmediumlarge skillsarray- Skills to install, each owner/repo/skill-name (create)
statusstring- Which boxes to list (list, default: active)one of
activedeleted ttlinteger- Lifetime in seconds of an ephemeral box (create, max 259200 = 3 days)
upstashmcp_box_previewManages public preview URLs for ports inside a box, so a service running in it is reachable from the internet.DestructiveManage Box Preview URLs
Manages public preview URLs for ports inside a box, so a service running in it is reachable from the internet. Actions: create (needs port; basic_auth or bearer_token add a generated credential, which is returned once and only here), list, delete (needs port). box_id is required for every action.
Inputs
actionstringrequired- The action to performone of
createlistdelete box_idstringrequired- The box ID (its name works too)
basic_authboolean- Protect the preview with a generated username and password (create)
bearer_tokenboolean- Protect the preview with a generated bearer token (create)
portinteger- Port inside the box (required for create and delete)
upstashmcp_box_runsInspects a box's run history — agent prompts, shell executions and browser runs — with their status, output, token usage and cost.DestructiveList Box Runs
Inspects a box's run history — agent prompts, shell executions and browser runs — with their status, output, token usage and cost. Actions: list, get (needs run_id), cancel (needs run_id; only a run that is still running can be cancelled). box_id is required for every action.
- Idempotent
Inputs
actionstringrequired- The action to performone of
listgetcancel box_idstringrequired- The box ID (its name works too)
run_idstring- Run ID (required for get and cancel actions)
upstashmcp_box_schedulesCron schedules that run a shell command or an agent prompt inside a box on a UTC cron expression.DestructiveManage Box Schedules
Cron schedules that run a shell command or an agent prompt inside a box on a UTC cron expression. Actions: create (needs cron and either command or prompt), list, get, update, pause, resume, delete (the last five need schedule_id). update changes only the fields given, so a new cron leaves the command alone. An agent prompt runs on the provider key saved on the account (or set on the box) and fails without one. timeout is milliseconds; 0 clears it on update. Read-only OAuth connections are refused with 403 on the actions that write.
Inputs
actionstringrequired- The action to performone of
createlistgetupdatepauseresumedelete box_idstringrequired- The box ID (its name works too)
commandarray- Command as an argv array, for a shell schedule
cronstring- Cron expression, UTC, e.g. '0 9 * * *'
folderstring- Working directory inside the box (defaults to /workspace/home)
modelstring- Model for an agent schedule
promptstring- Prompt, for an agent schedule
schedule_idstring- Schedule ID (required for get, update, pause, resume, delete)
timeoutinteger- Milliseconds; 0 clears it on update
upstashmcp_box_snapshotsManages box snapshots — full filesystem copies a new box can be built from.DestructiveManage Box Snapshots
Manages box snapshots — full filesystem copies a new box can be built from. Actions: create (needs box_id), list (one box's snapshots, needs box_id), list_all (every snapshot in the account), delete (needs box_id and snapshot_id), restore (needs snapshot_id; creates a NEW box from the snapshot and leaves the original alone, inheriting the snapshot's model and runtime unless they are overridden).
Inputs
actionstringrequired- The action to perform. 'list' lists one box's snapshots, 'list_all' lists every snapshot in the accountone of
createlistlist_alldeleterestore box_idstring- Box ID (required for create, list, delete)
env_varsobject- Environment variables for the restored box (restore)
ephemeralboolean- Create the restored box as ephemeral (restore)
labelsarray- Labels for the restored box (restore)
modelstring- LLM model for the restored box (restore, defaults to the snapshot's)
namestring- Name for the snapshot (create, auto-generated if omitted)
runtimestring- Override the snapshot's runtime for the restored box (restore)
snapshot_idstring- Snapshot ID (required for delete and restore)
ttlinteger- Lifetime in seconds of a restored ephemeral box (restore, max 3 days)
upstashmcp_dlq_manageManages a dead-letter-queue entry: get or delete (QStash and Workflow), restart or resume (Workflow only).DestructiveManage Dead Letter Queue
Manages a dead-letter-queue entry: get or delete (QStash and Workflow), restart or resume (Workflow only).
Inputs
actionstringrequired- No description.one of
getdeleterestartresume dlqIdstringrequired- The DLQ entry ID
regionstringrequired- QStash region of your QStash userone of
euus servicestringrequired- Which service the operation targets: plain QStash messaging or Upstash Workflowone of
qstashworkflow
upstashmcp_index_deletePERMANENTLY deletes an entire Vector index or Search database, everything stored in it and its credentials.DestructiveDelete Index
PERMANENTLY deletes an entire Vector index or Search database, everything stored in it and its credentials. This cannot be undone. To empty one while keeping it, use index_reset; to remove a single namespace or named index, use index_delete_namespace.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_delete_documentsDeletes documents from a namespace, leaving the namespace and the index in place.DestructiveDelete Index Documents
Deletes documents from a namespace, leaving the namespace and the index in place. Payload e.g. {"ids":["a","b"]}, {"prefix":"doc-"} or {"filter":"..."}. To empty a namespace entirely use index_reset; to delete the index itself use index_delete.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON delete payload
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch namespacestring- Vector: the namespace (omit for the default one). Search: the named index, which is required — list them with index_list_namespaces
upstashmcp_index_delete_namespacePERMANENTLY deletes a namespace and everything in it — for a Search database, one of its named indexes.DestructiveDelete Index Namespace
PERMANENTLY deletes a namespace and everything in it — for a Search database, one of its named indexes. This cannot be undone. The default namespace cannot be deleted; empty it with index_reset instead.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
namespacestringrequired- The namespace to delete, or for Search the named index. Required — there is no default
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_rename_namespaceRenames a namespace — for a Search database, one of its named indexes.DestructiveRename Index Namespace
Renames a namespace — for a Search database, one of its named indexes. The new name must not already be in use, and the default namespace cannot be renamed.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
namespacestringrequired- The namespace to rename, or for Search the named index
newNamespacestringrequired- The new name
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_resetPERMANENTLY deletes every document in a namespace, leaving the empty namespace behind.DestructiveReset Index
PERMANENTLY deletes every document in a namespace, leaving the empty namespace behind. Set allNamespaces to empty the whole index instead. This cannot be undone.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch allNamespacesboolean- Empty every namespace of the index rather than one. Cannot be combined with namespace
namespacestring- Vector: the namespace (omit for the default one). Search: the named index, which is required — list them with index_list_namespaces
upstashmcp_index_reset_credentialsResets the REST token and read-only token of a Vector index or a Search database.DestructiveReset Index Credentials
Resets the REST token and read-only token of a Vector index or a Search database. Every client still using the old ones fails from that moment, so the user has to update their apps' environment variables. The new tokens are not in the result: fetch them with index_get and include_credentials: true. Confirm with the user before calling.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_set_planMoves a Vector index or a Search database to another plan: payg (billed per request) or fixed (a flat monthly price).DestructiveChange Index Plan
Moves a Vector index or a Search database to another plan: payg (billed per request) or fixed (a flat monthly price). Search is billed as Vector, so one pricing page covers both: https://upstash.com/pricing/vector.md — its "Pay as You Go" is payg and "Fixed" is fixed; Pro is sold by sales. The current plan is type in index_get. Only an index already on a paid plan can switch; the API refuses a free one. This changes what the account is billed: tell the user the price from the pricing page and get their confirmation before calling.
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
planstringrequired- The plan to move toone of
paygfixed servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch
upstashmcp_index_updateUpdates one existing document in place, without re-sending the rest of it.DestructiveUpdate Index
Updates one existing document in place, without re-sending the rest of it. Payload e.g. {"id":"a","metadata":{...},"metadataUpdateMode":"patch"} to merge into the existing metadata, or "overwrite" (the default) to replace it; may also carry vector, sparseVector or data to re-embed. Does nothing if the id does not exist — use vector_upsert or search_upsert to create.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON update payload
servicestringrequired- Which product the index belongs to. A Vector index and a Search database are separate resources — the API returns 404 if this names the wrong oneone of
vectorsearch namespacestring- Vector: the namespace (omit for the default one). Search: the named index, which is required — list them with index_list_namespaces
upstashmcp_qstash_flow_control_manageManages a flow-control key: pause, resume, pin (payload = pin options JSON), unpin (payload = unpin options JSON) or reset_rate.DestructiveManage QStash Flow Control
Manages a flow-control key: pause, resume, pin (payload = pin options JSON), unpin (payload = unpin options JSON) or reset_rate.
- Idempotent
Inputs
actionstringrequired- No description.one of
pauseresumepinunpinreset_rate keystringrequired- Flow-control key
regionstringrequired- QStash region of your QStash userone of
euus payloadstring- JSON options for pin/unpin
upstashmcp_qstash_manage_scheduleManages a QStash schedule: create (destinationUrl + cron required), get, delete, pause or resume (scheduleId required).DestructiveManage QStash Schedule
Manages a QStash schedule: create (destinationUrl + cron required), get, delete, pause or resume (scheduleId required).
Inputs
actionstringrequired- No description.one of
creategetdeletepauseresume regionstringrequired- QStash region of your QStash userone of
euus bodystring- Message body for created schedules
cronstring- Cron expression, e.g. */5 * * * *
destinationUrlstring- No description.
scheduleIdstring- The QStash schedule ID
upstashmcp_qstash_reset_tokenReplaces a region's QStash token and read-only token without downtime, in two calls.DestructiveReset QStash Token
Replaces a region's QStash token and read-only token without downtime, in two calls. QStash and Workflow share one QStash user per region, so every app publishing with QSTASH_TOKEN, and every Workflow client, needs the new token; the request signing keys are not changed. 1) Call without roll_to: resets nothing and returns the next token pair, which QStash already accepts alongside the current token (the same pair comes back until the roll). For Vercel marketplace users this also writes the next token to their Vercel env as QSTASH_TOKEN. 2) Once the user's apps run with next_token, call with roll_to set to it: that token becomes the current one and the old token stops working within seconds. If the roll fails, do not retry it: an earlier roll that timed out may have gone through (check with qstash_list_users and include_credentials: true), otherwise start over from step 1. Confirm with the user before rolling.
Inputs
regionstringrequired- QStash region of your QStash userone of
euus roll_tostring- The next_token from the first call, already deployed. Omit to get the next token pair
upstashmcp_qstash_set_budgetSets the monthly spending cap of a region's pay-as-you-go QStash user; fixed plans have none.DestructiveSet QStash Budget
Sets the monthly spending cap of a region's pay-as-you-go QStash user; fixed plans have none. Once the month's cost reaches the cap the bill stops growing and the user is rate limited. 0 removes the cap. Changing the budget, including to 0, lifts an active rate limit right away. A non-zero cap must be above what the user has already cost this month, and setting the value it already has fails with "budget already set". The current cap is budget in qstash_list_users. QStash and Upstash Workflow share one QStash user per region, so this covers both. Prices: https://upstash.com/pricing/qstash.md (Workflow: https://upstash.com/pricing/workflow.md). Confirm the amount with the user before calling.
Inputs
budgetintegerrequired- Monthly spending cap in whole US dollars: 0 removes the cap, otherwise 20 to 10000
regionstringrequired- QStash region of your QStash userone of
euus
upstashmcp_qstash_set_planMoves a region's QStash user to another plan: pay-as-you-go (billed per message) or a fixed monthly tier.DestructiveChange QStash Plan
Moves a region's QStash user to another plan: pay-as-you-go (billed per message) or a fixed monthly tier. QStash and Upstash Workflow share one QStash user per region, so this covers both. Prices: https://upstash.com/pricing/qstash.md (Workflow: https://upstash.com/pricing/workflow.md). On the pricing page "Pay as You Go" is payg, "Fixed 1M" is fixed_1m and "Fixed 10M" is fixed_10m. The current plan is type and reserved_type in qstash_list_users. The plan can change at most once an hour. This changes what the account is billed: tell the user the price from the pricing page and get their confirmation before calling.
Inputs
planstringrequired- The plan to move toone of
paygfixed_1mfixed_10m regionstringrequired- QStash region of your QStash userone of
euus
upstashmcp_qstash_set_prod_packEnables or disables Prod Pack on a region's QStash user, a monthly add-on for pay-as-you-go and fixed plans that adds an uptime SLA, encryption at rest, SOC-2 compliance and Prometheus/Datadog metrics.DestructiveSet QStash Prod Pack
Enables or disables Prod Pack on a region's QStash user, a monthly add-on for pay-as-you-go and fixed plans that adds an uptime SLA, encryption at rest, SOC-2 compliance and Prometheus/Datadog metrics. QStash and Upstash Workflow share one QStash user per region, so this covers both. Prices: https://upstash.com/pricing/qstash.md (Workflow: https://upstash.com/pricing/workflow.md). Only accounts with a payment method can enable it, and asking for the state it is already in fails with "Prod Pack is already enabled/disabled". This changes what the account is billed: tell the user the price from the pricing page and get their confirmation before calling.
Inputs
enabledbooleanrequired- true to enable Prod Pack, false to disable it
regionstringrequired- QStash region of your QStash userone of
euus
upstashmcp_redis_change_planMoves an Upstash Redis database to another plan: pay-as-you-go (billed per command) or a fixed monthly tier.DestructiveChange Redis Plan
Moves an Upstash Redis database to another plan: pay-as-you-go (billed per command) or a fixed monthly tier. Prices and limits: https://upstash.com/pricing/redis.md — its "Pay as You Go" is payg and "Fixed 250MB" … "Fixed 500GB" are fixed_250mb … fixed_500gb. The current plan is the database's type and reserved_type in redis_get_database. A branch is always pay-as-you-go and refuses this. A database cannot be moved back to the free plan, and the plan can change at most once every 5 minutes. prod_pack and auto_upgrade can be set in the same call. This changes what the account is billed: tell the user the price from the pricing page and get their confirmation before calling.
Inputs
databaseIdstringrequired- The Redis database ID
planstringrequired- The plan to move toone of
paygfixed_250mbfixed_1gbfixed_5gbfixed_10gbfixed_50gbfixed_100gbfixed_500gb auto_upgradeboolean- Also enable or disable automatic plan upgrade; omit to leave it as it is
prod_packboolean- Also enable (true) or disable (false) Prod Pack; omit to leave it as it is
upstashmcp_redis_delete_databasePERMANENTLY deletes an Upstash Redis database or branch and all of its data.DestructiveDelete Redis Database
PERMANENTLY deletes an Upstash Redis database or branch and all of its data. This cannot be undone. A database that still has branches is refused until they are deleted; deleting a branch leaves its database untouched. Confirm the database name with the user before calling. When the client supports it, the server asks the user to type the name itself; otherwise the call needs confirm_name, set to the name the user confirmed, and without it nothing is deleted.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
confirm_namestring- The exact name of the resource, as the user confirmed it. Ask the user to confirm the name before setting this; never fill it in on your own. Ignored when the client can ask the user directly
upstashmcp_redis_rename_databaseRenames an Upstash Redis database or branch.DestructiveRename Redis Database
Renames an Upstash Redis database or branch. A branch's name can use letters, numbers, hyphens, underscores and dots, starting and ending with a letter or number, and must be unique among the branches of its database.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
namestringrequired- The new database name (alphanumeric)
upstashmcp_redis_reset_credentialsResets an Upstash Redis database's password and REST tokens (read-write and read-only).DestructiveReset Redis Credentials
Resets an Upstash Redis database's password and REST tokens (read-write and read-only). Every client still using the old ones fails from that moment, so the user has to update their apps' environment variables. Refused for HIPAA-compliant databases and for databases whose credentials are managed as Vercel Marketplace environment variables. Also refused for a database with Protect Credentials enabled: its new password is shown only once, which this tool never does, so it would be lost; reset it in the Upstash console. The new credentials are not in the result: fetch them with redis_get_database and include_credentials: true. Confirm with the user before calling.
Inputs
databaseIdstringrequired- The Redis database ID
upstashmcp_redis_run_commandRuns Redis commands directly on an Upstash Redis database over its REST API.DestructiveRun Redis Command
Runs Redis commands directly on an Upstash Redis database over its REST API. No tokens needed — credentials are resolved server-side and never exposed. Not available for a database with Protect Credentials enabled (is_password_protected in redis_get_database): Upstash keeps no password for it. Each command is an array of strings, e.g. [["SET","key","value"],["GET","key"]]. One command runs directly; several run as a pipeline. Note for SCAN: reuse the returned cursor, and stop to ask the user if results get large.
Inputs
commandsarrayrequired- Redis commands, each as an array of strings
databaseIdstringrequired- The Redis database ID
upstashmcp_redis_set_auto_upgradeEnables or disables automatic plan upgrade for an Upstash Redis database.DestructiveSet Redis Auto-Upgrade
Enables or disables automatic plan upgrade for an Upstash Redis database.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
enabledbooleanrequired- true to enable auto-upgrade, false to disable
upstashmcp_redis_set_budgetSets the monthly spending cap of a pay-as-you-go Upstash Redis database; fixed plans have none.DestructiveSet Redis Budget
Sets the monthly spending cap of a pay-as-you-go Upstash Redis database; fixed plans have none. The month's bill never exceeds the cap. Below $1000 the database is also rate limited once the cap is reached; at $1000 and above it keeps serving at full speed. Email warnings go out at 70% and 90%. 0 removes the cap. Changing the budget, including to 0, lifts an active rate limit right away. A non-zero cap must be above what the database has already cost this month, and setting the value it already has fails with "budget already set". The current cap is budget in redis_get_database. How budgets work: https://upstash.com/pricing/redis.md. Confirm the amount with the user before calling.
Inputs
budgetintegerrequired- Monthly spending cap in whole US dollars: 0 removes the cap, otherwise 20 to 10000
databaseIdstringrequired- The Redis database ID
upstashmcp_redis_set_evictionEnables or disables key eviction for an Upstash Redis database.DestructiveSet Redis Eviction
Enables or disables key eviction for an Upstash Redis database.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
enabledbooleanrequired- true to enable eviction, false to disable
upstashmcp_redis_set_prod_packEnables or disables Prod Pack on an Upstash Redis database: a per-database monthly add-on for pay-as-you-go and fixed plans that adds an uptime SLA, multi-zone high availability, encryption at rest, SOC-2 compliance and Prometheus/Grafana/Datadog metrics.DestructiveSet Redis Prod Pack
Enables or disables Prod Pack on an Upstash Redis database: a per-database monthly add-on for pay-as-you-go and fixed plans that adds an uptime SLA, multi-zone high availability, encryption at rest, SOC-2 compliance and Prometheus/Grafana/Datadog metrics. Price and the full feature list: https://upstash.com/pricing/redis.md. Only accounts with a payment method can enable it. Not available on a branch. This changes what the account is billed: tell the user the price from the pricing page and get their confirmation before calling.
- Idempotent
Inputs
databaseIdstringrequired- The Redis database ID
enabledbooleanrequired- true to enable Prod Pack, false to disable it
upstashmcp_redis_update_read_regionsReplaces the read regions of a global Upstash Redis database with the given list: regions not in it are removed along with their replicas, new ones are added.DestructiveUpdate Redis Read Regions
Replaces the read regions of a global Upstash Redis database with the given list: regions not in it are removed along with their replicas, new ones are added. Pass the full list (redis_get_database shows the current read_regions and primary_region); an empty list removes every read region. The primary region can't be a read region, a free database can have at most one, and the regions can change at most once every 30 minutes. Regional, HIPAA and Enterprise databases and branches are refused. Adding read regions costs more: on a fixed plan each one adds the plan's per-region price, and on pay-as-you-go every write is replicated to each read region and billed as another command, with storage counted in every region (https://upstash.com/pricing/redis.md). Confirm the regions and the cost with the user before calling.
Inputs
databaseIdstringrequired- The Redis database ID
read_regionsarrayrequired- The complete list of read regions the database should have, e.g. ["us-west-2", "eu-central-1"]
upstashmcp_search_upsertUpserts documents into a named index of a Search database (server-side embedding), creating the named index if it does not exist.DestructiveUpsert Search Documents
Upserts documents into a named index of a Search database (server-side embedding), creating the named index if it does not exist. Payload e.g. [{"id":"movie-1","content":{"title":"Star Wars"},"metadata":{...}}].
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
indexNamestringrequired- The named index inside the Search database
payloadstringrequired- JSON documents payload
upstashmcp_vector_upsertUpserts vectors into a Vector index.DestructiveUpsert Vectors
Upserts vectors into a Vector index. Payload e.g. [{"id":"a","vector":[...],"metadata":{...}}] — or with useData=true, [{"id":"a","data":"text to embed"}]. For a Search database use search_upsert instead.
- Idempotent
Inputs
indexIdstringrequired- The Vector index ID, or the Search database ID
payloadstringrequired- JSON payload as the Vector REST API expects
namespacestring- Namespace to write to (omit for the default namespace)
useDataboolean- true = /upsert-data (server-side embedding)
upstashmcp_workflow_manage_runOperates on a Workflow run.DestructiveManage Workflow Run
Operates on a Workflow run. To inspect a run by ID (its state, steps and errors, whether it has finished or not), use logs_list with service workflow and workflowRunId instead. get_steps is the narrower view: the live step state of a run that is still in progress. For a run that has finished or been cancelled, get_steps falls back to that run's log entry and says so. cancel asks QStash to stop the run and is asynchronous: the run moves to RUN_CANCELED in logs_list (service workflow) after a short delay, and the cancel call itself does not confirm that a run with this ID existed. Check logs_list, not get_steps, to verify a cancel.
- Idempotent
Inputs
actionstringrequired- No description.one of
get_stepscancel regionstringrequired- QStash region of your QStash userone of
euus workflowRunIdstringrequired- The workflow run ID, which always starts with wfr_. A custom ID passed as workflowRunId when triggering is stored with that prefix (my-run-1 becomes wfr_my-run-1), and the prefix is required here. logs_list (service workflow) shows the exact IDs.
No tools match.