Upstash MCP Server

decr

If the key does not exist, it is initialized to 0 before the operation. Returns the new value after decrementing. Decrement a numeric value in Upstash Redis

del

Returns 1 if the key was deleted, 0 if it did not exist. WARNING: this operation is irreversible. Delete a key from Upstash Redis

exists

This is a lightweight way to check key presence without retrieving the value. Check if a key exists in Upstash Redis

expire

The key will be automatically deleted when the TTL reaches zero. Returns 1 if the timeout was set, 0 if the key does not exist. Set a TTL on a key in Upstash Redis

get

Returns null if the key does not exist. This is the primary read operation for string data. Get a value from Upstash Redis

hget

Returns null if the key or field does not exist. Get a field value from a Redis hash

hgetall

Returns an object with all fields and their values. Returns an empty object if the key does not exist. Get all fields and values from a Redis hash

hset

If the key does not exist, a new hash is created. If the field already exists, its value is overwritten. Returns the number of fields added (1 for new, 0 for updated). Set a field in a Redis hash

incr

If the key does not exist, it is initialized to 0 before the operation. Returns the new value after incrementing. Increment a numeric value in Upstash Redis

key_type

Get the data type of a key in Upstash Redis

list_keys

Use "*" for all keys, "prefix:*" for keys with a prefix, or "*:suffix" for suffix matching. WARNING: KEYS can be slow on large databases — use sparingly. List keys in Upstash Redis

llen

Returns 0 if the key does not exist. Get the length of a Redis list

lpush

If the key does not exist, a new list is created. Returns the length of the list after the push. Push values to the left of a Redis list

lrange

Use 0 as start and -1 as stop to get all elements. Positive indices count from the head (0 = first), negative indices count from the tail (-1 = last). Get a range of elements from a Redis list

pipeline

Commands are sent as a JSON array of arrays, e.g. [["SET","k1","v1"],["GET","k1"],["INCR","counter"]]. Returns an array of results in the same order. Note: the pipeline is NOT atomic (other commands may interleave) — use /multi-exec for atomicity. WARNING: this is a powerful tool — review commands carefully before execution. Execute multiple commands atomically via Upstash pipeline

publish

Returns the number of subscribers that received the message. This is a fire-and-forget operation — subscribers must be actively listening. Publish a message to a Redis channel

rpush

If the key does not exist, a new list is created. Returns the length of the list after the push. Push values to the right of a Redis list

sadd

Duplicate members are ignored. If the key does not exist, a new set is created. Returns the number of members that were added. Add members to a Redis set

set

Optionally set an expiry time in seconds using the ex parameter. Overwrites any existing value at the key. Returns "OK" on success. This is the primary write operation for string data. Set a value in Upstash Redis

sismember

This is a fast O(1) membership check. Check if a member is in a Redis set

smembers

Returns an array of all unique members. Returns an empty array if the key does not exist. Get all members of a Redis set

srem

Non-existent members are ignored. Returns the number of members that were removed. Remove members from a Redis set

ttl

Returns -1 if the key has no expiry, -2 if the key does not exist. Get the TTL of a key in Upstash Redis