Redis Mcp

[Add to Cursor]

Lightweight MCP server for Redis with only two tools:

• 🧪 redis_run_commands: run one or more Redis commands over HTTP/REST or TCP, as a pipeline or an atomic transaction.
• 📚 redis_search_docs: search the Redis docs using Context7 public api.

One server can hold multiple named databases. Configuration is pure environment variables and CLI flags.

🔌 Quickstart

claude mcp add upstash-redis \  -e UPSTASH_REDIS_REST_URL=https://<your-db>.upstash.io \  -e UPSTASH_REDIS_REST_TOKEN=<your-rest-token> \  -- npx -y @upstash/redis-mcp

{  "mcpServers": {    "upstash-redis": {      "command": "npx",      "args": ["-y", "@upstash/redis-mcp"],      "env": {        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"      }    }  }}

{  "servers": {    "upstash-redis": {      "command": "npx",      "args": ["-y", "@upstash/redis-mcp"],      "env": {        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"      }    }  }}

[mcp_servers.upstash-redis]command = "npx"args = ["-y", "@upstash/redis-mcp"]env = { UPSTASH_REDIS_REST_URL = "https://<your-db>.upstash.io", UPSTASH_REDIS_REST_TOKEN = "<your-rest-token>" }

{  "mcp": {    "upstash-redis": {      "type": "local",      "command": ["npx", "-y", "@upstash/redis-mcp"],      "environment": {        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"      }    }  }}

[!TIP] Any MCP-compatible client works. If yours isn't listed, add a stdio server that runs npx -y @upstash/redis-mcp with the two env vars above.

🧰 Tools

🧪 redis_run_commands

Run any Redis command: GET, SET, SCAN, ZADD, EVAL, the SEARCH.* family, and everything else. Each command is an array of args (numbers are accepted and coerced to strings). By default multiple commands run as a pipeline: each returns its own result/error, aligned to the input, and one failure doesn't abort the rest. Set transaction: true for an atomic MULTI/EXEC.

{  "commands": [    ["SET", "visits", 0],    ["INCR", "visits"],    ["GET", "visits"],  ],  "transaction": false, // optional: true => atomic MULTI/EXEC  // "database": "prod"       // only when more than one database is configured  // raw credential overrides (optional):  // "rest_url", "rest_token" // HTTP  // "connection_string"      // TCP, rediss://}

The transport (HTTP vs TCP) is determined by how the target database is configured; the agent never picks it.

📚 redis_search_docs

Searches the Upstash Redis documentation live and returns the most relevant pages. Reach for it whenever you're unsure about a command or feature, especially Upstash-specific ones like the SEARCH.* full-text search family. It's powered by Context7's free tier, so no API key or extra setup is required.

{ "query": "SEARCH.AGGREGATE date histogram" }

⚙️ Configuration

Everything is set through environment variables and CLI flags; there are no config files.

Single database

Multiple databases

Give each database a name. The name becomes a selectable database value in redis_run_commands.

Environment: insert a <NAME> segment:

UPSTASH_REDIS_PROD_REST_URL="https://prod-db.upstash.io"UPSTASH_REDIS_PROD_REST_TOKEN="<prod-rest-token>"UPSTASH_REDIS_CACHE_TCP_URL="rediss://default:<password>@cache-db.upstash.io:6379"

CLI: repeat --database to start each group:

npx -y @upstash/redis-mcp \  --database prod  --rest-url https://prod-db.upstash.io --rest-token <prod-rest-token> \  --database cache --url rediss://default:<password>@cache-db.upstash.io:6379

[!NOTE] Raw credentials per call. A redis_run_commands call may also pass rest_url + rest_token (HTTP) or connection_string (TCP) inline; these override the registry and work even with no configured database. They flow through the model's context, so prefer env/CLI for anything sensitive.

Flags & options

📡 Telemetry

HTTP/REST requests carry Upstash-Telemetry-{Sdk,Platform,Runtime} headers. Disable with --disable-telemetry or UPSTASH_DISABLE_TELEMETRY=true.

🏃 Run it locally

bun installbun run build                 # emits dist/index.jscp .env.example .env          # add UPSTASH_REDIS_REST_URL + UPSTASH_REDIS_REST_TOKEN
node dist/index.js                          # stdio (what clients spawn)node dist/index.js --transport http --port 3000   # HTTP: endpoint /mcp, health /ping

The server auto-loads .env. To point a client at your local build, swap npx -y @upstash/redis-mcp in any Quickstart config for node /absolute/path/to/redis-mcp/dist/index.js.

🛠️ Development

bun installbun run buildbun testbun run lint

📄 License

MIT © Upstash