Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions agent-resources/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
12 changes: 7 additions & 5 deletions agent-resources/mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<AccordionGroup>
<Accordion title="Redis — 18 tools">
<Accordion title="Redis — 20 tools">
| 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 |
Expand All @@ -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.
Expand Down Expand Up @@ -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 |
Expand Down
13 changes: 8 additions & 5 deletions llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.

<AccordionGroup>
<Accordion title="Redis — 18 tools">
<Accordion title="Redis — 20 tools">
| 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 |
Expand All @@ -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.
Expand Down Expand Up @@ -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 |
Expand Down