Where do I find my Upstash REST URL and Token?

Log in to the [**Upstash Console**](https://console.upstash.com), select your Redis database, and look for the **REST API** section. You'll find the HTTPS Endpoint (your REST URL, e.g. `https://xxx-yyy-12345.upstash.io`) and the **Token** value. Copy both and paste them here. There are two token types: Standard (full access) and Read-Only (read-only commands). Use Standard for full functionality.

What Redis commands are supported via the REST API?

The Upstash REST API supports most Redis commands including: Strings (GET, SET, DEL, EXISTS, EXPIRE, TTL, INCR, DECR), Hashes (HSET, HGET, HGETALL), Lists (LPUSH, RPUSH, LRANGE, LLEN), Sets (SADD, SMEMBERS, SISMEMBER, SREM), Keys (KEYS, TYPE, PING), and Pub/Sub (PUBLISH). The pipeline endpoint allows executing multiple commands in a single request. Blocking commands (BLPOP, BRPOP) and WATCH/UNWATCH are not supported.

Can I execute multiple commands atomically?

The `pipeline` tool sends multiple commands in a single HTTP request for efficiency, but it is NOT atomic — other commands may interleave between them. For atomic multi-command execution, Upstash supports the `/multi-exec` endpoint (same syntax as pipeline but guarantees atomicity). However, this MCP server currently exposes the standard pipeline tool for batch operations.

Is the Upstash REST API rate-limited?

Upstash does not enforce a fixed RPS limit. Instead, your plan defines a daily command limit. Each REST call counts as one command (or multiple commands if using pipeline). If you exceed your daily limit, commands will fail with a 400 error. Check your Upstash console for current usage. For high-throughput scenarios, consider using the pipeline endpoint to batch multiple commands into single HTTP requests.

Upstash MCP Server for OpenAI Agents SDK 23 tools — connect in under 2 minutes

Name: Upstash
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 23 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Upstash through the Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails — no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

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

async def main():
    # Your Vinkius token — get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Upstash Assistant",
            instructions=(
                "You help users interact with Upstash. "
                "You have access to 23 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Upstash"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Upstash MCP Server

Connect your Upstash Redis database to any AI agent and interact with your serverless data store through natural conversation — no Redis CLI needed.

The OpenAI Agents SDK auto-discovers all 23 tools from Upstash through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns — chain multiple agents where one queries Upstash, another analyzes results, and a third generates reports, all orchestrated through the Vinkius.

What you can do

Health Checks — Ping your database to verify connectivity and inspect server health
String Operations — Get, set and delete key-value pairs with optional TTL management
Hash Management — Store and retrieve structured data as field-value pairs within hash keys
List Operations — Push, pop and range elements from Redis lists for queue and stack patterns
Set Operations — Add, remove and query set membership for unique collections
Key Discovery — List keys by pattern, check existence, inspect data types and view TTL values
Numeric Operations — Increment and decrement counters atomically
Pub/Sub Messaging — Publish messages to channels for event-driven architectures
Pipeline Execution — Execute multiple commands in a single HTTP request for batch operations

The Upstash MCP Server exposes 23 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Upstash to OpenAI Agents SDK via MCP

Follow these steps to integrate the Upstash MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 23 tools from Upstash

Why Use OpenAI Agents SDK with the Upstash MCP Server

OpenAI Agents SDK provides unique advantages when paired with Upstash through the Model Context Protocol.

Native MCP integration via `MCPServerSse` — pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Upstash + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Upstash MCP Server delivers measurable value.

Automated workflows: build agents that query Upstash, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents — one queries Upstash, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Upstash tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Upstash to resolve tickets, look up records, and update statuses without human intervention

Upstash MCP Tools for OpenAI Agents SDK (23)

These 23 tools become available when you connect Upstash to OpenAI Agents SDK via MCP:

decr

If the key does not exist, it is initialized to 0 before the operation. Returns the new value after decrementing. Decrement a numeric value in Upstash Redis

del

Returns 1 if the key was deleted, 0 if it did not exist. WARNING: this operation is irreversible. Delete a key from Upstash Redis

exists

This is a lightweight way to check key presence without retrieving the value. Check if a key exists in Upstash Redis

expire

The key will be automatically deleted when the TTL reaches zero. Returns 1 if the timeout was set, 0 if the key does not exist. Set a TTL on a key in Upstash Redis

get

Returns null if the key does not exist. This is the primary read operation for string data. Get a value from Upstash Redis

hget

Returns null if the key or field does not exist. Get a field value from a Redis hash

hgetall

Returns an object with all fields and their values. Returns an empty object if the key does not exist. Get all fields and values from a Redis hash

hset

If the key does not exist, a new hash is created. If the field already exists, its value is overwritten. Returns the number of fields added (1 for new, 0 for updated). Set a field in a Redis hash

incr

If the key does not exist, it is initialized to 0 before the operation. Returns the new value after incrementing. Increment a numeric value in Upstash Redis

key_type

Get the data type of a key in Upstash Redis

list_keys

Use "*" for all keys, "prefix:*" for keys with a prefix, or "*:suffix" for suffix matching. WARNING: KEYS can be slow on large databases — use sparingly. List keys in Upstash Redis

llen

Returns 0 if the key does not exist. Get the length of a Redis list

lpush

If the key does not exist, a new list is created. Returns the length of the list after the push. Push values to the left of a Redis list

lrange

Use 0 as start and -1 as stop to get all elements. Positive indices count from the head (0 = first), negative indices count from the tail (-1 = last). Get a range of elements from a Redis list

pipeline

Commands are sent as a JSON array of arrays, e.g. [["SET","k1","v1"],["GET","k1"],["INCR","counter"]]. Returns an array of results in the same order. Note: the pipeline is NOT atomic (other commands may interleave) — use /multi-exec for atomicity. WARNING: this is a powerful tool — review commands carefully before execution. Execute multiple commands atomically via Upstash pipeline

publish

Returns the number of subscribers that received the message. This is a fire-and-forget operation — subscribers must be actively listening. Publish a message to a Redis channel

rpush

If the key does not exist, a new list is created. Returns the length of the list after the push. Push values to the right of a Redis list

sadd

Duplicate members are ignored. If the key does not exist, a new set is created. Returns the number of members that were added. Add members to a Redis set

set

Optionally set an expiry time in seconds using the ex parameter. Overwrites any existing value at the key. Returns "OK" on success. This is the primary write operation for string data. Set a value in Upstash Redis

sismember

This is a fast O(1) membership check. Check if a member is in a Redis set

smembers

Returns an array of all unique members. Returns an empty array if the key does not exist. Get all members of a Redis set

srem

Non-existent members are ignored. Returns the number of members that were removed. Remove members from a Redis set

ttl

Returns -1 if the key has no expiry, -2 if the key does not exist. Get the TTL of a key in Upstash Redis

Example Prompts for Upstash in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Upstash immediately.

"Check if my Upstash Redis database is responding."

"Set a feature flag called 'dark_mode' to true for user 'user123' with a 1 hour expiry."

"Show me all keys matching the pattern 'session:*' and check their data types."

Troubleshooting Upstash MCP Server with OpenAI Agents SDK

Common issues when connecting Upstash to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Upstash + OpenAI Agents SDK FAQ

Common questions about integrating Upstash MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.