Upstash MCP Server

🚀 Upstash MCP Server

The Model Context Protocol (MCP) is a new standard protocol for managing context between Large Language Models (LLMs) and external systems. In this repository, we provide an installer and an MCP server for the Upstash Developer API.

This allows you to use Claude Desktop or any MCP client to perform operations on your Upstash account using natural language, such as:

• "Create a new Redis database in the us-east-1 region"
• "List all databases"
• "Show keys starting with 'user:' (e.g., in users-db)"
• "Create a backup"
• "Give me the data on throughput peaks in the past 7 days"

🚀 Quick Start

Prerequisites

• Node.js >= v18.0.0
• Claude Desktop
• Upstash API Key - You can create one here.

Local Usage

Installation via npx

1. Run npx @upstash/mcp-server init <UPSTASH_EMAIL> <UPSTASH_API_KEY>
2. Restart Claude Desktop
3. You should now be able to use Upstash commands in Claude Desktop

See the Quick Start Guide in the MCP documentation. You can also contact us via Discord.

⚠️ Important Note

If you use a node version management tool such as nvm or fnm, please refer to this issue. You should replace the node command in the MCP configuration with the absolute path to the node binary.

Installation via Smithery

To automatically install Upstash via Smithery:

npx -y @smithery/cli install @upstash/mcp-server --client claude

Tools

Redis

• redis_database_create_backup
• redis_database_create_new
• redis_database_delete
• redis_database_delete_backup
• redis_database_get_details
• redis_database_list_backups
• redis_database_list_databases
• redis_database_reset_password
• redis_database_restore_backup
• redis_database_run_multiple_redis_commands
• redis_database_run_single_redis_command
• redis_database_set_daily_backup
• redis_database_update_regions
• redis_database_get_usage_last_5_days
• redis_database_get_stats

Development

Clone the project and run:

bun install
npm run watch

This will continuously build the project and watch for changes.

For testing, you can create a .env file in the project directory with the following content:

UPSTASH_EMAIL=<UPSTASH_EMAIL>
UPSTASH_API_KEY=<UPSTASH_API_KEY>

Using Docker

To run the MCP server using Docker, run the following commands:

docker build -t upstash-mcp-server .
docker run -it --rm upstash-mcp-server

⚠️ Important Note

In a Docker environment, you need to manually create a .env file and set UPSTASH_API_KEY to your Upstash API key.

Troubleshooting

If you encounter any issues, please refer to the FAQ or seek help on Discord.