Skip to content
Merged
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
3 changes: 0 additions & 3 deletions _snippets/redis/start-redis-snippet.mdx

This file was deleted.

19 changes: 18 additions & 1 deletion agent-resources/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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'
Expand Down
5 changes: 5 additions & 0 deletions agent-resources/mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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"
Expand Down
7 changes: 6 additions & 1 deletion devops/developer-api/openapi.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
50 changes: 44 additions & 6 deletions llms-full.txt
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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'
Expand Down Expand Up @@ -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>
Expand All @@ -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"
Expand Down Expand Up @@ -7627,6 +7651,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

Expand Down Expand Up @@ -16222,7 +16250,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
Expand Down Expand Up @@ -16599,6 +16627,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.
Expand Down Expand Up @@ -17770,6 +17800,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
Expand Down Expand Up @@ -17939,6 +17973,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
Expand Down Expand Up @@ -20968,7 +21006,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>

***
Expand Down Expand Up @@ -22732,7 +22770,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
Expand Down Expand Up @@ -25143,7 +25181,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
Expand Down
4 changes: 3 additions & 1 deletion llms.txt
Original file line number Diff line number Diff line change
@@ -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
Expand Down
18 changes: 11 additions & 7 deletions llms/src/build.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down Expand Up @@ -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`;
Expand Down Expand Up @@ -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`;
Expand Down
7 changes: 4 additions & 3 deletions redis/features/globaldatabase.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 2 additions & 0 deletions redis/features/restapi.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 4 additions & 0 deletions redis/howto/connect-client.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
5 changes: 5 additions & 0 deletions redis/howto/connect-with-upstash-redis.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,11 @@ 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
Expand Down
Loading