{
  "schema_version": 2,
  "id": "integrate/redis-mcp/remote-cloud-mcp",
  "title": "Redis Cloud remote MCP server",
  "url": "https://redis.io/docs/latest/integrate/redis-mcp/remote-cloud-mcp/",
  "summary": "Connect an MCP client to the Redis Cloud MCP server that Redis hosts.",
  "tags": [
    "docs",
    "integrate",
    "rc"
  ],
  "last_updated": "2026-11-10T13:19:37+02:00",
  "page_type": "content",
  "content_hash": "99bd67532374e010a709d96fe928c498407b29405384a5769ec21f98e57e99e2",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Redis hosts a Model Context Protocol (MCP) server for\n[Redis Cloud](https://redis.io/docs/latest/operate/rc) at `https://cloud.mcp.redis.io/mcp`.\nConnect an MCP client to it to manage your subscriptions, databases, and\nAgent Memory stores from an AI assistant. There is nothing to install or run:\nyou add one URL and your Redis Cloud API keys to your client.\n\nUse requests like these:\n\n- \"List my subscriptions and their databases\"\n- \"Create a free Essentials database on AWS in us-east-1\"\n- \"Which regions can I use for an Essentials plan on Google Cloud?\"\n- \"Show the metrics for my Agent Memory store\"\n\n> [!NOTE]\n> The remote server manages Redis Cloud resources. It doesn't read or write the\n> data inside your databases. To work with your data, use\n> [Redis MCP](https://redis.io/docs/latest/integrate/redis-mcp). To work with the memories\n> in an Agent Memory store, use the store's\n> [MCP endpoint](https://redis.io/docs/latest/develop/ai/context-engine/agent-memory/mcp). To\n> give your agent the Redis documentation, use\n> [Redis Docs MCP](https://redis.io/docs/latest/develop/setup/build-with-an-agent#redis-docs-mcp).\n> To run a server yourself, use the\n> [local Redis Cloud MCP server](https://redis.io/docs/latest/integrate/redis-mcp/install#redis-cloud-mcp)."
    },
    {
      "id": "before-you-begin",
      "title": "Before you begin",
      "role": "content",
      "text": "You need:\n\n- A Redis Cloud account with the\n  [Redis Cloud API enabled](https://redis.io/docs/latest/operate/rc/api/get-started/enable-the-api).\n- An API account key and an API user key. See\n  [Manage API keys](https://redis.io/docs/latest/operate/rc/api/get-started/manage-api-keys).\n- An MCP client that supports Streamable HTTP and custom request headers.\n  Clients that only support OAuth sign-in can't connect.\n\nThe server acts as the API user key's user, so it can do only what that user\ncan do in the Redis Cloud console:\n\n- To create, update, or delete resources, use a user key for a user with the\n  owner role.\n- If the user key has a Classless Inter-Domain Routing (CIDR) allow list, add\n  the address your MCP client connects from.\n\nTo create, update, or delete resources, your client must also support MCP\nelicitation (form requests). The server uses it to ask you to confirm a change."
    },
    {
      "id": "connect-your-client",
      "title": "Connect your client",
      "role": "content",
      "text": "The [Agents page](https://cloud.redis.io/#/agents/mcp) in the Redis Cloud\nconsole has guided setup. Choose your agent, and the page shows the\nconfiguration to copy and links to where you create your API keys.\n\nTo connect by hand, use the same settings in every client:\n\n| Setting | Value |\n|---|---|\n| URL | `https://cloud.mcp.redis.io/mcp` |\n| `x-api-key` header | Your API account key |\n| `x-api-secret-key` header | Your API user key |\n\nKeep your keys in the client's connection settings. Don't put them in prompts or\nagent instructions."
    },
    {
      "id": "codex",
      "title": "Codex",
      "role": "content",
      "text": "Set the `REDIS_CLOUD_API_KEY` and `REDIS_CLOUD_API_SECRET_KEY` environment\nvariables to your API account key and API user key. Then add the server to\n`~/.codex/config.toml`:\n\n[code example]"
    },
    {
      "id": "claude-code",
      "title": "Claude Code",
      "role": "content",
      "text": "[code example]"
    },
    {
      "id": "cursor",
      "title": "Cursor",
      "role": "content",
      "text": "Add the server to `~/.cursor/mcp.json`:\n\n[code example]"
    },
    {
      "id": "vs-code",
      "title": "VS Code",
      "role": "content",
      "text": "Set the `REDIS_CLOUD_API_KEY` and `REDIS_CLOUD_API_SECRET_KEY` environment\nvariables to your API account key and API user key before you start VS Code.\nThen add the server to `.vscode/mcp.json` in your workspace:\n\n[code example]\n\nTo check the connection, ask your assistant to list your Redis Cloud\nsubscriptions."
    },
    {
      "id": "what-you-can-do",
      "title": "What you can do",
      "role": "content",
      "text": "Your client shows two tools, `search_tools` and `call_tool`. Your assistant\nsearches for the Redis Cloud tool it needs and then calls it, so your client's\ntool list stays short. Clients that support MCP Apps also get `call_ui_tool`,\nwhich opens interactive views such as Agent Memory store metrics.\n\n| Resource | View | Create, update, and delete |\n|---|---|---|\n| Redis Cloud Essentials subscriptions and databases | Yes | Yes |\n| Redis Cloud Pro subscriptions and databases | Yes | No |\n| Agent Memory stores and their metrics | Yes | Yes |\n| Plans, regions, payment methods, and cloud accounts | Yes | No |\n\nPayment methods show only the card type, the last four digits, and the expiry\ndate.\n\nSome changes finish in the background. For these, the server returns a task,\nand your assistant can check the task's status."
    },
    {
      "id": "confirm-changes",
      "title": "Confirm changes",
      "role": "content",
      "text": "The server asks you to confirm before most changes:\n\n| Change | How you confirm |\n|---|---|\n| Delete a subscription, database, or Agent Memory store | Type the resource name exactly. |\n| Update a resource, create a paid subscription, or create an Agent Memory store | Approve the change in your client. |\n| Create a free subscription or a database | No confirmation. |\n\nIf you decline or cancel, nothing changes. The server never retries a change\nautomatically."
    },
    {
      "id": "limits",
      "title": "Limits",
      "role": "limits",
      "text": "- Each tool call must finish in about 25 seconds. A change that times out might\n  still complete, so check the resource before you try again.\n- Lists return every matching resource in your account. They aren't paginated.\n- The server limits how many requests it accepts. Over the limit, calls fail\n  with `Global rate limit exceeded`. Wait, then try again.\n- Calls to manage subscriptions and databases also count toward your\n  [Redis Cloud API quota](https://redis.io/docs/latest/operate/rc/api/examples/usage-quota-and-throttling)."
    },
    {
      "id": "troubleshooting",
      "title": "Troubleshooting",
      "role": "errors",
      "text": "| Problem | Cause | Fix |\n|---|---|---|\n| Your client reports HTTP 401 | A key is missing or wrong. | Check both headers and their values. |\n| Your client reports HTTP 403 | The server can't check your access right now. | Try again in a few minutes. |\n| A call fails with `Global rate limit exceeded` | Too many requests. | Wait, then try again. |\n| A change stops at the confirmation step | Your client doesn't support MCP elicitation. | Use a client that supports elicitation. |\n| A change fails with a permission error | The user key's user doesn't have the owner role. | Use a user key for an owner. |"
    }
  ],
  "examples": [
    {
      "id": "codex-ex0",
      "language": "toml",
      "code": "[mcp_servers.redis-cloud]\nurl = \"https://cloud.mcp.redis.io/mcp\"\nenv_http_headers = { \"x-api-key\" = \"REDIS_CLOUD_API_KEY\", \"x-api-secret-key\" = \"REDIS_CLOUD_API_SECRET_KEY\" }",
      "section_id": "codex"
    },
    {
      "id": "claude-code-ex0",
      "language": "bash",
      "code": "claude mcp add --transport http redis-cloud https://cloud.mcp.redis.io/mcp \\\n  --header \"x-api-key: <your-api-account-key>\" \\\n  --header \"x-api-secret-key: <your-api-user-key>\"",
      "section_id": "claude-code"
    },
    {
      "id": "cursor-ex0",
      "language": "json",
      "code": "{\n  \"mcpServers\": {\n    \"redis-cloud\": {\n      \"url\": \"https://cloud.mcp.redis.io/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"<your-api-account-key>\",\n        \"x-api-secret-key\": \"<your-api-user-key>\"\n      }\n    }\n  }\n}",
      "section_id": "cursor"
    },
    {
      "id": "vs-code-ex0",
      "language": "json",
      "code": "{\n  \"servers\": {\n    \"redis-cloud\": {\n      \"type\": \"http\",\n      \"url\": \"https://cloud.mcp.redis.io/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"${env:REDIS_CLOUD_API_KEY}\",\n        \"x-api-secret-key\": \"${env:REDIS_CLOUD_API_SECRET_KEY}\"\n      }\n    }\n  }\n}",
      "section_id": "vs-code"
    }
  ]
}