How to Use the Upstash Redis MCP in OpenAI Agents SDK

Q: How does Upstash Redis help with connection stability when using the OpenAI Agents SDK?

The ping tool lets your agents verify the connection status before making any calls. If the ping fails, your agent knows to stop and alert you, preventing bad data writes.

Q: Does Upstash Redis handle complex structures with the OpenAI Agents SDK?

It handles basic key-value strings. You can use get and set for simple data transfers. While it's not a document database, it’s perfect for fast counters or lookup tables.

Q: What is the best way to manage keys in Upstash Redis for the OpenAI Agents SDK?

Use listkeys with glob patterns instead of wildcards. This makes sure your agent only scans relevant parts of the database, keeping performance high.

Give your OpenAI Agents SDK the power to manage key/value data directly.

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 OpenAI Agents SDK

Create your Vinkius account to connect Upstash Redis to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Redis Status with MCP Server

Need to know if the connection's good? Use `ping` to verify connectivity instantly. Your agent runs a quick check, confirming the Redis instance is up and ready for action.

Updating Data State in OpenAI Agents SDK

Use the `set` tool to write data or refresh it. You can specify an expiration time right away, so you don't accidentally keep old records forever. This keeps your agent’s memory clean and current.

Monitoring Keys with MCP Server

Want visibility into what data exists? The `get_key_info` tool tells you the data type and how long a key is valid for. This helps your agent decide if it should even bother trying to read or update that specific piece of data.

Setup guide

Set up Upstash Redis MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Upstash Redis tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Upstash Redis tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Upstash Redis tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Upstash Redis Agent",
            instructions="You have access to Upstash Redis tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

The `ping` tool lets your agents verify the connection status before making any calls. If the ping fails, your agent knows to stop and alert you, preventing bad data writes.

It handles basic key-value strings. You can use `get` and `set` for simple data transfers. While it's not a document database, it’s perfect for fast counters or lookup tables.

It stores key-value string pairs. This means you're dealing with simple text data attached to a specific identifier (the key). It doesn’t handle complex JSON objects directly.

Use `list_keys` with glob patterns instead of wildcards. This makes sure your agent only scans relevant parts of the database, keeping performance high.

This server touches simple key-value string data. You are responsible for managing persistence; it's crucial to have a backup plan outside of this MCP Server.

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