How to Use the Upstash Redis MCP in Windsurf

Q: How does Upstash Redis help Windsurf manage session data?

Windsurf uses set and getkeyinfo to track active user sessions. It sets a unique key with an expiration time, letting the agent know exactly when the session will automatically expire.

Q: Can Windsurf use Upstash Redis for rate limiting?

Yes. By using increment, Windsurf can maintain running counts for API calls or usage limits per user key. The client also uses getkeyinfo to ensure the counter hasn't hit its defined TTL.

Q: What data types does Upstash Redis support for Windsurf?

The server handles string and integer values. When using delete, you specify which keys hold these simple data types that need removal from the database.

Manage key-value data structures with Windsurf’s autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Upstash Redis MCP to Windsurf

Create your Vinkius account to connect Upstash Redis 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 Redis with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Accessing and Managing Keys via MCP Server

The `get` tool lets your AI client fetch the string value for any given key. If you need to know more than just the data, use `get_key_info`. This tells you if the key has an expiration date (TTL) and what kind of data it holds. Cascade can automatically check connectivity first with `ping` before attempting data manipulation. You'll also manage expirations using `set`, which allows you to assign a time limit in seconds.

Counting Transactions for Windsurf

When tracking activity, the `increment` tool handles numeric counters. It increases or decreases the count at a key; just remember that negative numbers make it decrement instead. This is useful when your agent needs to calculate things like daily user views. You can also manage these counts by deleting old keys using `delete`, which accepts a comma-separated list of keys.

Discovering Data Structures with the MCP Server

Don't rely solely on knowing your key names. The `list_keys` tool scans for keys that match a specific pattern, helping you map out your data structure. Remember to keep patterns narrow; don't run it against huge databases using just an asterisk (`*`). Need to clean up old records? Use the `delete` function to remove one or more keys at once by listing them with commas.

Setup guide

Set up Upstash Redis 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 Redis 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 Redis payment history." If connected, Cascade will call the Upstash Redis tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "upstash-redis-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 Redis. 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 Redis 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 Redis MCP in Windsurf

Windsurf uses `set` and `get_key_info` to track active user sessions. It sets a unique key with an expiration time, letting the agent know exactly when the session will automatically expire.

Yes. By using `increment`, Windsurf can maintain running counts for API calls or usage limits per user key. The client also uses `get_key_info` to ensure the counter hasn't hit its defined TTL.

The server handles string and integer values. When using `delete`, you specify which keys hold these simple data types that need removal from the database.

It's an MCP Server designed to work across various clients. Your AI client connects using a single endpoint token and gains access to all available tools for managing the key-value data.

This server primarily works with string and integer values. The `get` tool reads these simple types, which are often used to store identifiers or numeric counters.

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