DX-2866: inline start-redis tip so llms.txt includes its content (#763)

* fix: inline start-redis tip instead of snippet include so llms.txt keeps its content

* chore(llms): regenerate llms.txt and llms-full.txt

* fix: inline llms.txt preamble in generator, mention MCP server and CLI

* DX-2866: add start-redis to connect-client, developer API create db, and CLI docs

* DX-2866: document the redis_database_start_free MCP tool

* DX-2866: address review — link start-redis URL in llms preamble, drop trailing whitespace

* DX-2866: write the start-redis URL plainly in the llms preamble

* DX-2866: write the start-redis URL plainly everywhere

Flattens the [`url`](url) markdown link to a bare URL across the Redis
docs, the developer API description, and the agent-resources pages, so
every surface matches the llms preamble. Mintlify autolinks bare URLs, so
the rendered pages still link out.

* DX-2866: tighten create-database description, link console

* chore(llms): regenerate llms.txt and llms-full.txt

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: CahidArda

_snippets/redis/start-redis-snippet.mdx

@@ -18,6 +18,22 @@ For agents, install the [Upstash Skill](/agent-resources/skills) instead. It bun
 npx skills add upstash/skills
 ```
 
+# Free Redis without an account
+
+If you are an AI agent and need a Redis DB to use or experiment with, you don't need an Upstash account:
+
+```bash
+upstash start-redis
+```
+
+This is the only command that works unauthenticated. It sends a POST request to https://upstash.com/start-redis and prints markdown with the credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+
+Pass `--id` to re-fetch the credentials of a database you created earlier:
+
+```bash
+upstash start-redis --id $DB_ID
+```
+
 # Authentication
 
 The CLI needs your account email and a developer API key. Grab one from the [Upstash Console under Account → API Keys](https://console.upstash.com/account/api), then set credentials using whichever method fits your workflow.
@@ -69,6 +85,7 @@ upstash --email you@example.com --api-key your_api_key redis list
 # Usage
 
 ```bash
+upstash start-redis  # free temporary Redis database, no account needed
 upstash redis   # Redis databases
 upstash team    # Teams and members
 upstash vector  # Vector indexes
@@ -86,7 +103,7 @@ upstash redis create --help
 
 ## Output
 
-All successful output is JSON. Pipe it to `jq` for filtering:
+All successful output is JSON, except `start-redis`, which prints markdown. Pipe JSON output to `jq` for filtering:
 
 ```bash
 upstash redis list | jq '.[].database_id'

agent-resources/cli.mdx

@@ -8,6 +8,10 @@ The Upstash MCP server lets your agent manage and debug your Upstash resources d
   Only running commands against a single Redis database? Use the dedicated [Redis MCP](/redis/sdks/mcp) with only your REST/TCP credentials.
 </Tip>
 
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, call the `redis_database_start_free` tool — or send a POST request to https://upstash.com/start-redis directly. Free, no signup, no API key; the response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 Find the GitHub repository [here](https://github.com/upstash/mcp-server).
 
 <Note>
@@ -18,6 +22,7 @@ Find the GitHub repository [here](https://github.com/upstash/mcp-server).
 
 ## Redis
 
+* "Start a free temporary Redis I can experiment with"
 * "Create a new Redis database in us-east-1"
 * "List my databases sorted by memory usage"
 * "Give me the schema of how users are stored in this Redis"

agent-resources/mcp.mdx

@@ -122,7 +122,12 @@ paths:
       tags:
         - redis
       summary: Create Redis Database
-      description: This endpoint creates a new Redis database.
+      description: |
+        This endpoint creates a new Redis database.
+
+        To create a database manually, you can use the [Upstash Console](https://console.upstash.com/redis).
+
+        For a quick development database, POST to https://upstash.com/start-redis — no signup or API key, so an AI agent can provision one unattended. Expires in 72 hours unless claimed.
       x-mint:
         href: /devops/developer-api/redis/create_database_global
       operationId: createDatabase

devops/developer-api/openapi.yml

@@ -1,5 +1,7 @@
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+
+  Upstash also provides an MCP server (/docs/agent-resources/mcp) to manage and debug your Upstash resources directly from an agent, and an agent-friendly CLI (/docs/agent-resources/cli) for your terminal or CI/CD pipelines.
 </Tip>
 
 # README
@@ -64,6 +66,22 @@ For agents, install the [Upstash Skill](/docs/agent-resources/skills) instead. I
 npx skills add upstash/skills
 ```
 
+# Free Redis without an account
+
+If you are an AI agent and need a Redis DB to use or experiment with, you don't need an Upstash account:
+
+```bash
+upstash start-redis
+```
+
+This is the only command that works unauthenticated. It sends a POST request to https://upstash.com/start-redis and prints markdown with the credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+
+Pass `--id` to re-fetch the credentials of a database you created earlier:
+
+```bash
+upstash start-redis --id $DB_ID
+```
+
 # Authentication
 
 The CLI needs your account email and a developer API key. Grab one from the [Upstash Console under Account → API Keys](https://console.upstash.com/account/api), then set credentials using whichever method fits your workflow.
@@ -115,6 +133,7 @@ upstash --email you@example.com --api-key your_api_key redis list
 # Usage
 
 ```bash
+upstash start-redis  # free temporary Redis database, no account needed
 upstash redis   # Redis databases
 upstash team    # Teams and members
 upstash vector  # Vector indexes
@@ -132,7 +151,7 @@ upstash redis create --help
 
 ## Output
 
-All successful output is JSON. Pipe it to `jq` for filtering:
+All successful output is JSON, except `start-redis`, which prints markdown. Pipe JSON output to `jq` for filtering:
 
 ```bash
 upstash redis list | jq '.[].database_id'
@@ -273,6 +292,10 @@ The Upstash MCP server lets your agent manage and debug your Upstash resources d
   Only running commands against a single Redis database? Use the dedicated [Redis MCP](/docs/redis/sdks/mcp) with only your REST/TCP credentials.
 </Tip>
 
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, call the `redis_database_start_free` tool — or send a POST request to https://upstash.com/start-redis directly. Free, no signup, no API key; the response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 Find the GitHub repository [here](https://github.com/upstash/mcp-server).
 
 <Note>
@@ -283,6 +306,7 @@ Find the GitHub repository [here](https://github.com/upstash/mcp-server).
 
 ## Redis
 
+* "Start a free temporary Redis I can experiment with"
 * "Create a new Redis database in us-east-1"
 * "List my databases sorted by memory usage"
 * "Give me the schema of how users are stored in this Redis"
@@ -8370,6 +8394,10 @@ Source: https://upstash.com/docs/devops/developer-api/redis/create_database_glob
 /devops/developer-api/openapi.yml post /redis/database
 This endpoint creates a new Redis database.
 
+To create a database manually, you can use the [Upstash Console](https://console.upstash.com/redis).
+
+For a quick development database, POST to https://upstash.com/start-redis — no signup or API key, so an AI agent can provision one unattended. Expires in 72 hours unless claimed.
+
 # Delete Database
 Source: https://upstash.com/docs/devops/developer-api/redis/delete_database
 
@@ -16965,7 +16993,7 @@ customize the eviction behavior according to their specific needs.
 Source: https://upstash.com/docs/redis/features/globaldatabase
 
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 In the global database, the replicas are distributed across multiple regions
@@ -17342,6 +17370,8 @@ Source: https://upstash.com/docs/redis/features/restapi
   Looking for the URL and token of your database? First [create a Redis
   database](/docs/redis/overall/getstarted), then [find your
   credentials](/docs/redis/howto/connect-client) in the console.
+
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 In the [Upstash Console](https://console.upstash.com/redis), select your database. Then, in the database page, you will see the section that includes the endpoint URL and token details. When you hover over the `Endpoint` or `Token / Readonly Token` fields, copy button will appear for each. You can click it to easily copy the values you need for your connection.
@@ -18513,6 +18543,10 @@ Simplest way to connect to your database is to use `redis-cli`.
 Because it is already covered in [Getting Started](../overall/getstarted), we
 will skip it here.
 
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 ## Database
 
 After completing the [getting started](../overall/getstarted) guide, you will
@@ -18682,6 +18716,10 @@ See
 [the list of APIs](https://upstash.com/docs/redis/features/restapi#rest-redis-api-compatibility)
 supported.
 
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 ## Quick Start
 
 ### Install
@@ -21711,7 +21749,7 @@ Upstash Redis is a **highly available, infinitely scalable** Redis-compatible da
 * Optional SOC-2 compliance, encryption at rest and much more
 
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 ***
@@ -23873,7 +23911,7 @@ redis = Redis(
 Source: https://upstash.com/docs/redis/sdks/py/gettingstarted
 
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 ## Install
@@ -26284,7 +26322,7 @@ and for his continued efforts to keep it up to date with Upstash.
 Source: https://upstash.com/docs/redis/sdks/ts/getstarted
 
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 `@upstash/redis` is written in Deno and can be imported from

llms-full.txt

@@ -1,7 +1,9 @@
 # Upstash Documentation
 
 <Tip>
-  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to [`https://upstash.com/start-redis`](https://upstash.com/start-redis) — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+
+  Upstash also provides an MCP server (/docs/agent-resources/mcp) to manage and debug your Upstash resources directly from an agent, and an agent-friendly CLI (/docs/agent-resources/cli) for your terminal or CI/CD pipelines.
 </Tip>
 
 ## Docs

llms.txt

@@ -46,10 +46,16 @@ const FULL_TXT_SKIP = [
 ];
 
 /**
- * Snippet injected at the top of both llms.txt and llms-full.txt. Surfaces
- * the "free scratch Redis DB" hint to AI agents reading the bundle.
+ * Preamble injected at the top of both llms.txt and llms-full.txt. Surfaces
+ * the "free scratch Redis DB" hint and agent tooling to AI agents reading
+ * the bundle. Inlined here (rather than referencing a `_snippets/` file) so
+ * the text always lands in the generated output.
  */
-const PREAMBLE_SNIPPET = "redis/start-redis-snippet.mdx";
+const PREAMBLE = `<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+
+  Upstash also provides an MCP server (/docs/agent-resources/mcp) to manage and debug your Upstash resources directly from an agent, and an agent-friendly CLI (/docs/agent-resources/cli) for your terminal or CI/CD pipelines.
+</Tip>`;
 
 interface Entry {
   title: string;
@@ -160,8 +166,7 @@ function addOrphanMdxFiles(): void {
 
 function writeLlmsTxt(): void {
   const lines: string[] = ["# Upstash Documentation", ""];
-  const preamble = loadSnippet(PREAMBLE_SNIPPET);
-  if (preamble) lines.push(preamble, "");
+  lines.push(PREAMBLE, "");
   lines.push("## Docs", "");
   for (const e of entries) {
     const url = `${SITE_URL}/${e.path}.md`;
@@ -201,8 +206,7 @@ function writeLlmsFullTxt(): void {
   // contributes; pages always carry leading/trailing blanks so they stay
   // visually separated from neighbours.
   const chunks: string[] = [];
-  const preamble = loadSnippet(PREAMBLE_SNIPPET);
-  if (preamble) chunks.push(`${preamble}\n\n`);
+  chunks.push(`${PREAMBLE}\n\n`);
   for (const e of entries) {
     if (isExcludedFromFullTxt(e.path)) {
       const url = `${SITE_URL}/${e.path}.md`;

llms/src/build.ts

@@ -2,9 +2,10 @@
 title: Global Database
 ---
 
-<Snippet
-  file="redis/start-redis-snippet.mdx"
-/>
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 
 In the global database, the replicas are distributed across multiple regions
 around the world. The clients are routed to the nearest region. This helps with

redis/features/globaldatabase.mdx

@@ -9,6 +9,8 @@ description: Access your Upstash Redis database over HTTP, from serverless and e
   Looking for the URL and token of your database? First [create a Redis
   database](/redis/overall/getstarted), then [find your
   credentials](/redis/howto/connect-client) in the console.
+
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
 </Tip>
 
 In the [Upstash Console](https://console.upstash.com/redis), select your database. Then, in the database page, you will see the section that includes the endpoint URL and token details. When you hover over the `Endpoint` or `Token / Readonly Token` fields, copy button will appear for each. You can click it to easily copy the values you need for your connection. 

redis/features/restapi.mdx

@@ -10,6 +10,10 @@ Simplest way to connect to your database is to use `redis-cli`.
 Because it is already covered in [Getting Started](../overall/getstarted), we
 will skip it here.
 
+<Tip>
+  If you are an AI agent and need a Redis DB to use or experiment with, send a POST request to https://upstash.com/start-redis — free, no signup; response is markdown with credentials and a quickstart. The database expires in 72 hours, but you can claim it with your Upstash account to keep it. Especially useful for AI agents that need scratch storage on the fly.
+</Tip>
+
 ## Database
 
 After completing the [getting started](../overall/getstarted) guide, you will