Amazon ElastiCache Valkey MCP Server: Setup for Claude, Cursor and Other Apps

• Creates and manages search indexes

  Creates, drops, inspects or lists search indexes with text, number, tag and vector fields. It defaults to cosine distance and HNSW.

  Try: “Create a search index called products with title, category and price fields.”

  Delete · manage_index

• Adds documents to a search index

  Stores documents and can create embeddings for them with Bedrock, OpenAI or Ollama. It creates the index if missing.

  Try: “Add these three product records to the products index.”

  Write · add_documents

• Searches by meaning, text or both

  Runs semantic, text, hybrid or find-similar search. It picks the mode from your inputs unless you choose one.

  Try: “Find products similar to wireless headphones.”

  Network · search

• Groups and summarizes indexed data

  Builds a grouping, sorting and summary query over an index.

  Try: “Show the average price by category.”

  Read · aggregate

• Reads a JSON value

  Gets the JSON value at a path inside a Valkey key.

  Try: “Get $.settings.theme from the config key.”

  Read · json_get

• Writes a JSON value

  Sets a JSON value at a path, with an optional expiry time.

  Try: “Store this config JSON and expire it in an hour.”

  Write · json_set

• Appends to a JSON array

  Adds values to the end of a JSON array at a path.

  Try: “Add tag 'new' to the tags array.”

  Write · json_arrappend

• Removes an item from a JSON array

  Removes and returns an element from a JSON array.

  Try: “Pop the last item from the queue array.”

  Delete · json_arrpop

• Trims a JSON array

  Cuts a JSON array down to a chosen range.

  Try: “Keep only the first 100 items in the log array.”

  Delete · json_arrtrim

• Runs read-only Valkey commands

  Runs safe commands such as GET, HGETALL, SCAN and INFO. It works even in read-only mode.

  Try: “Show the first 20 keys that start with session:.”

  Read · valkey_read

• Runs commands that change data

  Runs commands such as SET, HSET, DEL and LPUSH. Destructive commands are blocked, and it is off in read-only mode.

  Try: “Set the key greeting to hello.”

  Delete · valkey_write

• Runs destructive admin commands

  Runs commands such as FLUSHALL, CONFIG SET and EVAL. It is off unless you set an admin variable and confirm each call.

  Try: “Flush the staging cache.”

  Delete · valkey_admin

Watch out for

• It can delete keys and data

  The write tool allows commands such as DEL, and the index tool can drop an index. Use the read-only flag unless you need changes. raw.githubusercontent.com

• Admin mode can wipe a cache

  The admin tool can run commands like FLUSHALL. It is off by default and needs an environment switch plus a confirmation on each call. raw.githubusercontent.com

• Text for search may be sent to an embedding service

  Adding documents or running meaning-based search sends text to Bedrock or OpenAI unless you use local Ollama. raw.githubusercontent.com

Security advisories