Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

Getting started

Installation

Prerequisites: Python 3.10 or later, uv, Access to a Valkey datastore

Configure your MCP client: Add the following to your MCP client configuration:

{
  "mcpServers": {
    "valkey": {
      "command": "uvx",
      "args": ["awslabs.valkey-mcp-server@latest"],
      "env": {
        "VALKEY_HOST": "<your-endpoint>",
        "VALKEY_SSL": "true"
      }
    }
  }
}

Replace <your-endpoint> with the endpoint of your Valkey datastore. Your coding agent must have network access to the endpoint.

Connecting to Amazon ElastiCache: ElastiCache Valkey clusters live in a private VPC and aren't reachable directly from your local machine. For SSM tunnel setup, IAM auth token generation, and TLS handling in tunnel mode, see the ElastiCache connection guide in the AWS Agent Toolkit, or install the Amazon ElastiCache Skill to let your agent handle the connection setup end-to-end. After the tunnel is established, use VALKEY_HOST=127.0.0.1 in the config above.

Restart your MCP client after saving the configuration.

You can prompt your agent to verify the connection with:

Use the Valkey MCP server to verify the connection to my datastore and confirm that Valkey operations are available.

Configuration

Configure the Valkey MCP server through environment variables in your MCP client configuration. You can also use the --readonly flag to restrict agent access to read-only operations.