Skip to main content
We provide an open source Upstash MCP to use natural language to interact with your Upstash account, e.g.:
  • “Create a new Redis database in us-east-1”
  • “List my databases”
  • “Show all keys starting with “user:” in my users-db”
  • “Create a backup”
  • “Show me the throughput spikes for the last 7 days”

​
Quickstart

​
Step 1: Get your API Key

  1. Go to Account > Management API > Create API key and create an API key.
  2. Note down your <UPSTASH_EMAIL> and <UPSTASH_API_KEY>.

​
Step 2: Locate mcp.json

  • Cursor: Navigate to Cursor Settings > Features > MCP and click + Add new global MCP server. This will open the mcp.json file.
  • Claude: Navigate to Settings > Developer and click Edit Config. This will open the claude_desktop_config.json file. Refer to the MCP documentation for more details.
  • Copilot: Create a .vscode/mcp.json file in your workspace directory. For Copilot, first update the mcp.json file as described in the next step on this page, then follow the Copilot documentation (starting from step 2) to configure MCP servers in VS Code Chat.

​
Step 3: Configure the MCP Server

If you’re using Claude Code, the easiest way to add the Upstash MCP server is via the CLI: 
claude mcp add upstash -- npx -y @upstash/mcp-server@latest \
  --email <UPSTASH_EMAIL> \
  --api-key <UPSTASH_API_KEY>
Verify the installation: 
claude mcp list
To share with your team (adds to .mcp.json in your project): 
claude mcp add upstash --scope project -- npx -y @upstash/mcp-server@latest \
  --email <UPSTASH_EMAIL> \
  --api-key <UPSTASH_API_KEY>

​
JSON Configuration (Cursor, Claude Desktop, Copilot)

Add the following configuration to your MCP file: 
{
  "mcpServers": {
    "upstash": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/mcp-server@latest",
        "--email",
        "<UPSTASH_EMAIL>",
        "--api-key",
        "<UPSTASH_API_KEY>"
      ]
    }
  }
}

​
Step 4: Use MCP with Your Client

Once your MCP is configured, your client can now interact with the MCP server for tasks like:
  • Seeding data
  • Querying databases
  • Creating new databases
  • Managing backups
  • Analyzing performance metrics
For example, you can ask your client to “add ten users to my Redis database” or “show me the throughput spikes for the last 7 days.”