• DISCOVERY
  • INSPECTION
  • MONITORING
  • HUMAN

How to inspect and debug Redis keys with your AI

Connect Upstash Redis to your AI client once. After that, you can query your database using plain English instead of CLI commands.

Ask AI about this page

Short answer

How can I debug Redis keys with my AI?

Your AI uses specific tools to pull key lists, inspect metadata, and read values directly from Upstash. You get instant visibility into data types and TTL settings without opening a terminal or a GUI. This breakdown shows how your agent handles those requests.

The outcomes

What you can do

The AI handles the heavy lifting of database inspection.

DISCOVERY

Find specific keys

The AI scans your database to locate keys matching your description. You get a clean list of what exists without manual pattern matching.

INSPECTION

Check data types

Your agent identifies if a key is a string, hash, or list. This helps you confirm your application is writing the right structures.

MONITORING

Verify expiration

The AI checks how much time is left before a key expires. You can quickly spot keys that are lingering too long or expiring too soon.

HUMAN

Manual data fixes

The AI can read and inspect data, but it won't change your values. You still handle the actual data migrations or deletions yourself.

The workflow

What your AI does when a request arrives.

The agent translates your questions into specific database operations.

  1. Locate keys

    The agent identifies which keys are currently active in your Upstash instance.

    list_keys
  2. Analyze metadata

    The AI pulls the specific properties and TTL information for a single key.

    get_key_info
  3. Read values

    Your agent fetches the actual content stored inside a specific key.

    get
  4. Summarize findings

    The AI interprets the raw data and expiration times into a readable report for you.

    get_key_info

Try it

Copy these to start.

Use these prompts to begin debugging.

Starting points

These are starting points. Replace the key names and patterns with your actual Redis data.

Upstash Redis Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_LWIxSXPx9aBN8ImAGEwBNh9Bp3KqtBybpfNFxgJc/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Upstash Redis capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "upstash-redis-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_LWIxSXPx9aBN8ImAGEwBNh9Bp3KqtBybpfNFxgJc/mcp"
    }
  }
}
Copy into chat04
  • List all keys in my Upstash Redis that start with 'user_session:'.

  • What is the data type and how much time is left before 'cache_token_99' expires?

  • Get the value for the key 'config:settings' and tell me if it's a JSON object.

  • Check the info for all keys matching 'auth_v2_*' to see their expiration timers.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Upstash Redis once, then ask.

You only need to link your Upstash credentials once. Your connection stays encrypted, and you can immediately start debugging via your preferred AI client.

Connect Upstash Redis to your AI

FAQ

Common questions

  • 01

    Can the AI delete keys for me?

    No. The current tools only allow the AI to list, inspect, and get data. It cannot delete or modify keys.

  • 02

    Can the AI change the TTL of a key?

    No. The AI can check the expiration timer using get_key_info, but it cannot update or reset it.

  • 03

    Does the AI see all my data?

    The AI only sees the data for the specific keys you ask it to inspect or the keys it finds during a list operation.

  • 04

    Can I use this with Cursor?

    Yes. Any MCP-compatible client like Cursor, Claude, or Windsurf works with this connector.

  • 05

    How does the AI know which keys to look for?

    You tell the AI which patterns or specific names to look for in your prompt, and it uses list_keys to find them.

  • More questions about Upstash Redis? The Connector page answers them. See everything the Upstash Redis Connector can do

Connect Upstash Redis to Claude, Cursor, ChatGPT & more