How to Use the Upstash MCP in Windsurf

Q: How do I manage data expiration using Upstash and Windsurf?

You set an expiry time on any key using expire. The key automatically deletes itself when the Time To Live (TTL) hits zero. You can check how much time is left with the ttl tool.

Q: What kind of data structures does Upstash support in Windsurf?

Upstash handles standard Redis types: strings (SET/GET), hashes (HSET/HGETALL), lists (LPUSH/RPOP), and sets (SADD). This allows your agent to manage almost any kind of structured data.

Q: Can I run multi-step transactions with Upstash in Windsurf?

Yes, you can use the pipeline tool. It sends a JSON array of commands so they execute as a batch. While it groups them together, remember that atomicity requires using a dedicated multi-exec feature.

Q: If I run a key deletion with Upstash in Windsurf, what happens?

The del tool removes a key entirely from the database. It's irreversible, so make sure you know exactly what data that key holds before running this operation.

Q: What specific data types can I query with Upstash and Windsurf?

You can check the type of any key using keytype. This tells your agent whether the data is a string, a list, a set, or a hash. It's critical for planning the next step.

Run complex data flows in Windsurf: Connect to Upstash for multi-step state management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Upstash MCP to Windsurf

Create your Vinkius account to connect Upstash to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Upstash with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Lists and Queues with MCP Server

The `rpush` tool lets you queue messages by adding values to the right side of a list. You can then retrieve them in order using `lrange`, or add multiple items at once with `lpush`. This handles basic queuing logic. Need to process commands atomically? Use `pipeline` to bundle several Redis operations into one call. Remember, this is powerful—check the command array carefully before execution.

Monitor Data State in Windsurf

If you need to know if a key exists without fetching its actual data, use `exists`. It's a quick check that saves bandwidth and time. For more context, the `ttl` tool tells you exactly how long a key remains active before it expires. Don't forget about checking complex structures. The `hgetall` method pulls every field and value from a hash, letting Cascade build its plan using all available data points.

Perform Atomic Counter Operations on MCP Server

To track counts, use the `incr` tool to increment a numeric key. If the key doesn't exist yet, Redis initializes it to zero first—that keeps your logic clean. The operation returns the new value after the count goes up. Counting is also possible with the `decr` tool, which decrements a number and reports the result. It’s essential for tracking limited resources or usage quotas.

Setup guide

Set up Upstash MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Upstash MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Upstash payment history." If connected, Cascade will call the Upstash tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "upstash-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Upstash. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Upstash now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Upstash MCP in Windsurf

You set an expiry time on any key using `expire`. The key automatically deletes itself when the Time To Live (TTL) hits zero. You can check how much time is left with the `ttl` tool.

Upstash handles standard Redis types: strings (`SET`/`GET`), hashes (`HSET`/`HGETALL`), lists (`LPUSH`/`RPOP`), and sets (`SADD`). This allows your agent to manage almost any kind of structured data.

Yes, you can use the `pipeline` tool. It sends a JSON array of commands so they execute as a batch. While it groups them together, remember that atomicity requires using a dedicated multi-exec feature.

The `del` tool removes a key entirely from the database. It's irreversible, so make sure you know exactly what data that key holds before running this operation.

You can check the type of any key using `key_type`. This tells your agent whether the data is a string, a list, a set, or a hash. It's critical for planning the next step.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript