How to Use the Upstash Redis MCP in Mastra AI

Q: What if my workflow needs to check connectivity before using Upstash Redis and Mastra AI?

You should start by running the ping tool. This immediately verifies that your connection endpoint is active, preventing the entire complex workflow from failing due to a simple network hiccup.

Q: If I need to clear data after a Mastra AI run using Upstash Redis, what's best?

Use the delete tool with a precise list of keys. Don't try to delete everything; always specify only the identifiers related to the completed workflow.

Build complex, failure-proof workflows using Upstash Redis with Mastra AI's agent framework.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run advanced counter logic

Use the `increment` tool to manage numeric counters in Upstash Redis. This allows your multi-step workflow to track usage or attempts precisely, handling the arithmetic inside the agent's execution cycle. If you need to reset a count, just use the standard key management tools and write a new value via `set`.

Retrieve necessary operational data

The `get` tool lets your workflow retrieve specific string values from Upstash Redis. This is how Mastra AI checks if a user exists or what their account balance is before proceeding with a step. Similarly, the `list_keys` function helps you find all relevant keys matching a pattern to gather context.

Manage key expiration and state

When data should expire, use `set`. You specify an expiry time in seconds, ensuring that transient information doesn't clutter your Upstash Redis database. This is critical for temporary workflow states. Need to know when a record expires? The `get_key_info` tool provides the TTL and data type.

Setup guide

Set up Upstash Redis MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Upstash Redis tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "upstash-redis-mcp-client",
  servers: {
    "upstash-redis-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Upstash Redis Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Upstash Redis tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Upstash Redis transactions"
);
console.log(result.text);

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 Mastra AI

Mastra AI uses keys in Upstash Redis to store intermediate workflow states. Tools like `get` and `set` allow the agent's internal memory to read and write required context between steps.

The core operations primarily deal with string values. For numeric counts, you rely on `increment`. The system tracks the type metadata using tools like `get_key_info`.

You should start by running the `ping` tool. This immediately verifies that your connection endpoint is active, preventing the entire complex workflow from failing due to a simple network hiccup.

Use the `delete` tool with a precise list of keys. Don't try to delete everything; always specify only the identifiers related to the completed workflow.

This server touches string values and numeric counters. Metadata about these keys (like TTL) is also managed, allowing your agent to track temporal validity.

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