Momento MCP Server

A simple Model Context Protocol (MCP) server implementation for Momento Cache.

Available on npmjs as @gomomento/mcp-momento

Tools

• get
• Get the cache value stored for the given key.
• Inputs:
  • key string -- the key to look up in the cache.
• Returns:
  • Hit with the found value if the key was found.
  • Miss if the key was not found.
  • Error if the request failed.
• set
• Sets the value in cache with a given Time To Live (TTL) seconds. If a value for this key is already present, it will be replaced by the new value regardless of the previous value's data type.
• Returns:
  • Success if the key was successfully written to the cache.
  • Error if the request failed.

Quickstart

1. Get a Momento API key from the Momento Console.

2. Set environment variables to configure the cache name and Time To Live (TTL) for items in the cache.

   # required
   export MOMENTO_API_KEY="your-api-key"
   
   # optional
   export MOMENTO_CACHE_NAME="your-cache-name"
   export DEFAULT_TTL_SECONDS=60
   

Usage with MCP Inspector

npx -y @modelcontextprotocol/inspector npx @gomomento/mcp-momento@latest

Usage with NPX on Claude Desktop

Note: if you're using nodenv, replace the plain npx with the path to your npx binary (e.g. /Users/username/.nodenv/shims/npx).

{
  "mcpServers": {
    "momento": {
      "command": "npx",
      "args": [
        "-y",
        "@gomomento/mcp-momento"
      ],
      "env": {
        "MOMENTO_API_KEY": "your-api-key",
        "MOMENTO_CACHE_NAME": "your-cache-name",
        "DEFAULT_TTL_SECONDS": 60
      }
    }
  }
}

Setup for local development

1. Install dependencies:

   npm install
   

2. Build the server:

   npm run build
   

3. Run with MCP Inspector bash export MOMENTO_API_KEY="your-api-key" npx @modelcontextprotocol/inspector node dist/index.js