diff --git a/agent-resources/cli.mdx b/agent-resources/cli.mdx index a03bdb627..e199208cd 100644 --- a/agent-resources/cli.mdx +++ b/agent-resources/cli.mdx @@ -146,6 +146,7 @@ upstash redis get --db-id $DB_ID upstash redis get --db-id $DB_ID --hide-credentials upstash redis create --name $NAME --region $REGION upstash redis create --name $NAME --region $REGION --read-regions $REGION_1 $REGION_2 +upstash redis create-branch --db-id $DB_ID --name $BRANCH_NAME upstash redis delete --db-id $DB_ID --dry-run upstash redis delete --db-id $DB_ID upstash redis rename --db-id $DB_ID --name $NEW_NAME diff --git a/agent-resources/mcp.mdx b/agent-resources/mcp.mdx index 233283586..5ed0d931d 100644 --- a/agent-resources/mcp.mdx +++ b/agent-resources/mcp.mdx @@ -114,24 +114,26 @@ A group covers every product it names, because those products share their tools: ## Tools -74 tools, grouped the way `?features=` groups them. The access column is the tool's own annotation, which clients use to decide what to confirm with you: **read** never changes anything, **write** only adds, **destructive** can delete or overwrite what is already there. On a read-only connection every write and destructive tool is refused. +76 tools, grouped the way `?features=` groups them, plus `submit_feedback_to_upstash_team`, which every connection gets for reporting a problem to the Upstash team. The access column is the tool's own annotation, which clients use to decide what to confirm with you: **read** never changes anything, **write** only adds, **destructive** can delete or overwrite what is already there. On a read-only connection every write and destructive tool is refused. The management tools that describe a resource (`redis_get_database`, `redis_create_database`, `index_get`, `index_create`, `qstash_list_users`) return its REST credentials only when called with `include_credentials: true`, so a routine lookup never carries a secret into the conversation. Listings never include credentials, and on a read-only connection they are omitted regardless. The plan, Prod Pack and budget tools change what your account is billed. They don't quote prices: each links the product's [pricing page](https://upstash.com/pricing) in its machine-readable form (for example `https://upstash.com/pricing/redis.md`) and tells the agent to give you the price and get your confirmation before calling. Budgets are whole US dollars, 0 for no cap or 20 to 10,000. Read regions count too: on a fixed plan each one adds the plan's per-region price. Moving a Redis database back to the free plan and the enterprise tiers aren't available through the MCP server; use the console or contact sales. - + | Tool | Access | What it does | | --- | --- | --- | - | `redis_list_databases` | read | Every Redis database in the account scope | + | `redis_list_databases` | read | Every Redis database in the account scope, including branches | | `redis_get_database` | read | One database in detail; REST credentials with `include_credentials` | | `redis_get_stats` | read | Throughput, latency, data size, hits and misses over a `period`; `refresh` recomputes the figures first | | `redis_get_insights` | read | Latency, throughput and replication lag per region, error counters, and anomalies the backend found | | `redis_get_traffic` | read | Where clients connect from, which SDKs they use, and how requests are routed | | `redis_list_backups` | read | Backups taken of a database | | `redis_create_database` | write | Creates a database, optionally on a given `plan`; returns its credentials with `include_credentials` | + | `redis_create_branch` | write | Creates a branch: a point-in-time copy of a database with its own endpoint and password, billed as pay-as-you-go | | `redis_create_backup` | write | Takes a manual backup | + | `redis_set_daily_backup` | write | Turns daily backups on or off | | `redis_rename_database` | destructive | Renames a database, replacing its current name | | `redis_set_eviction` | destructive | Turns key eviction on or off | | `redis_set_auto_upgrade` | destructive | Turns automatic plan upgrade on or off | @@ -140,7 +142,7 @@ The plan, Prod Pack and budget tools change what your account is billed. They do | `redis_set_budget` | destructive | Sets the monthly spending cap of a pay-as-you-go database | | `redis_update_read_regions` | destructive | Replaces a global database's read regions with the list you give it, at most once every 30 minutes | | `redis_reset_credentials` | destructive | Replaces the password and REST tokens; clients using the old ones stop working | - | `redis_delete_database` | destructive | Deletes a database and everything in it | + | `redis_delete_database` | destructive | Deletes a database or branch and everything in it; a database with branches is refused until they are deleted | | `redis_run_command` | destructive | Runs Redis commands over the REST API, one or a pipeline | `redis_run_command` is annotated destructive because it takes arbitrary commands. On a read-only connection it still works, but only for commands on an allowlist of read-only ones — anything else, including a command the server does not recognize, is refused. @@ -248,7 +250,7 @@ In ChatGPT and other hosts that support [MCP Apps](https://github.com/modelconte | Product | What you can do | | --- | --- | -| Redis | Browse and edit keys, run commands, view stats and Insights (with Prod Pack), create and delete databases; on **Settings**, change the plan, Prod Pack, budget, read regions, eviction and auto-upgrade, and reset credentials | +| Redis | Browse and edit keys, run commands, view stats and Insights (with Prod Pack), create and delete databases and branches; on **Settings**, change the plan, Prod Pack, budget, read regions, eviction and auto-upgrade, and reset credentials | | QStash | Publish messages, manage schedules, read logs and the DLQ, view stats; on **Settings**, change the region's plan, Prod Pack and budget, and reset its token (shared with Workflow) | | Workflow | Trigger runs, inspect and cancel them, retry from the DLQ, view stats | | Vector and Search | Browse documents by namespace, view stats; see the plan on **Settings**, switch a Vector index between pay-as-you-go and fixed, and reset credentials | diff --git a/llms-full.txt b/llms-full.txt index 03b7de4b6..e1777941d 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -193,6 +193,7 @@ upstash redis get --db-id $DB_ID upstash redis get --db-id $DB_ID --hide-credentials upstash redis create --name $NAME --region $REGION upstash redis create --name $NAME --region $REGION --read-regions $REGION_1 $REGION_2 +upstash redis create-branch --db-id $DB_ID --name $BRANCH_NAME upstash redis delete --db-id $DB_ID --dry-run upstash redis delete --db-id $DB_ID upstash redis rename --db-id $DB_ID --name $NEW_NAME @@ -1152,24 +1153,26 @@ A group covers every product it names, because those products share their tools: ## Tools -74 tools, grouped the way `?features=` groups them. The access column is the tool's own annotation, which clients use to decide what to confirm with you: **read** never changes anything, **write** only adds, **destructive** can delete or overwrite what is already there. On a read-only connection every write and destructive tool is refused. +76 tools, grouped the way `?features=` groups them, plus `submit_feedback_to_upstash_team`, which every connection gets for reporting a problem to the Upstash team. The access column is the tool's own annotation, which clients use to decide what to confirm with you: **read** never changes anything, **write** only adds, **destructive** can delete or overwrite what is already there. On a read-only connection every write and destructive tool is refused. The management tools that describe a resource (`redis_get_database`, `redis_create_database`, `index_get`, `index_create`, `qstash_list_users`) return its REST credentials only when called with `include_credentials: true`, so a routine lookup never carries a secret into the conversation. Listings never include credentials, and on a read-only connection they are omitted regardless. The plan, Prod Pack and budget tools change what your account is billed. They don't quote prices: each links the product's [pricing page](https://upstash.com/pricing) in its machine-readable form (for example `https://upstash.com/pricing/redis.md`) and tells the agent to give you the price and get your confirmation before calling. Budgets are whole US dollars, 0 for no cap or 20 to 10,000. Read regions count too: on a fixed plan each one adds the plan's per-region price. Moving a Redis database back to the free plan and the enterprise tiers aren't available through the MCP server; use the console or contact sales. - + | Tool | Access | What it does | | --- | --- | --- | - | `redis_list_databases` | read | Every Redis database in the account scope | + | `redis_list_databases` | read | Every Redis database in the account scope, including branches | | `redis_get_database` | read | One database in detail; REST credentials with `include_credentials` | | `redis_get_stats` | read | Throughput, latency, data size, hits and misses over a `period`; `refresh` recomputes the figures first | | `redis_get_insights` | read | Latency, throughput and replication lag per region, error counters, and anomalies the backend found | | `redis_get_traffic` | read | Where clients connect from, which SDKs they use, and how requests are routed | | `redis_list_backups` | read | Backups taken of a database | | `redis_create_database` | write | Creates a database, optionally on a given `plan`; returns its credentials with `include_credentials` | + | `redis_create_branch` | write | Creates a branch: a point-in-time copy of a database with its own endpoint and password, billed as pay-as-you-go | | `redis_create_backup` | write | Takes a manual backup | + | `redis_set_daily_backup` | write | Turns daily backups on or off | | `redis_rename_database` | destructive | Renames a database, replacing its current name | | `redis_set_eviction` | destructive | Turns key eviction on or off | | `redis_set_auto_upgrade` | destructive | Turns automatic plan upgrade on or off | @@ -1178,7 +1181,7 @@ The plan, Prod Pack and budget tools change what your account is billed. They do | `redis_set_budget` | destructive | Sets the monthly spending cap of a pay-as-you-go database | | `redis_update_read_regions` | destructive | Replaces a global database's read regions with the list you give it, at most once every 30 minutes | | `redis_reset_credentials` | destructive | Replaces the password and REST tokens; clients using the old ones stop working | - | `redis_delete_database` | destructive | Deletes a database and everything in it | + | `redis_delete_database` | destructive | Deletes a database or branch and everything in it; a database with branches is refused until they are deleted | | `redis_run_command` | destructive | Runs Redis commands over the REST API, one or a pipeline | `redis_run_command` is annotated destructive because it takes arbitrary commands. On a read-only connection it still works, but only for commands on an allowlist of read-only ones — anything else, including a command the server does not recognize, is refused. @@ -1286,7 +1289,7 @@ In ChatGPT and other hosts that support [MCP Apps](https://github.com/modelconte | Product | What you can do | | --- | --- | -| Redis | Browse and edit keys, run commands, view stats and Insights (with Prod Pack), create and delete databases; on **Settings**, change the plan, Prod Pack, budget, read regions, eviction and auto-upgrade, and reset credentials | +| Redis | Browse and edit keys, run commands, view stats and Insights (with Prod Pack), create and delete databases and branches; on **Settings**, change the plan, Prod Pack, budget, read regions, eviction and auto-upgrade, and reset credentials | | QStash | Publish messages, manage schedules, read logs and the DLQ, view stats; on **Settings**, change the region's plan, Prod Pack and budget, and reset its token (shared with Workflow) | | Workflow | Trigger runs, inspect and cancel them, retry from the DLQ, view stats | | Vector and Search | Browse documents by namespace, view stats; see the plan on **Settings**, switch a Vector index between pay-as-you-go and fixed, and reset credentials |