VECTOR SEARCH ENABLED

INSTANT SQL.
BUILT FOR AGENTS.

Zero friction. No signup. Just a JSON response.
Get a full-featured MySQL-compatible database with Vector & Full-Text Search in milliseconds.

Copy Command

curl -X POST https://api.tidb.instant/v1/database

TRY_DEMO

MySQL 8.0 CompatibleServerless

AI Ready

Native Vector Search integration. Store embeddings alongside relational data.

Full MySQL

Not a lite version. Joins, Transactions, and standard SQL support.

Disposable

72-hour lifespan. Use it for CI tests, demos, or agent sessions. Claim to keep.

Instant

Milliseconds to provision. No cold starts. Always ready for your query.

Agent
Playground

See how an AI Agent can spin up a database, enable vector search, seed data, and deploy a demo app in seconds using TiDB Instant.

Simulate Agent Workflow

Click to watch an agent build a "Vector Search E-commerce" demo from scratch.

Install MCP Skill

npx skills add https://github.com/tidbcloud/skills --skill tidb-instant

agent_executor_v2

-- TiDB INSTANT SYSTEM ONLINE. --

I provide instant, disposable TiDB instances equipped with Vector Search & Full-Text Search. Perfect for AI Agents.

THE API

POST/v1/database

Provisions a new TiDB Instant instance. Returns connection details immediately.

Request Body (Optional)

{
  "region": "us-west-2" // default
}

Response (200 OK)

{
  "database_id": "db_550e84...",
  "expires_at": "2026-02-01T10:00:00Z",
  "claim_url": "https://tidb.cloud/...",
  "status": "unclaimed",
  "connection": {
    "host": "gateway.tidb.cloud",
    "port": 4000,
    "user": "2FA9.root",
    "password": "...",
    "database": "db_550e84",
    "ssl": true,
    "dsn": "mysql://..."
  }
}

GET/v1/database/{database_id}

Retrieve connection details or check expiration status for an existing instance.

FAQ

What is TiDB Instant?

TiDB Instant is an API-first way to provision a disposable, full-featured TiDB (MySQL-compatible) database in seconds, with Vector Search and Full-Text Search enabled for AI workflows.

Who is TiDB Instant for?

AI agents, builders, developers, and teams who need fast, throwaway databases for demos, CI tests, prototypes, and short-lived agent sessions.

Do I need to sign up?

No sign-up is required to create an instance and get a JSON response with connection details. You only need to sign up if you want to claim and keep the instance in TiDB Cloud.

Is my data private?

Treat TiDB Instant as an experimental, disposable environment for demos and testing. Avoid storing secrets or regulated data. If you need stronger privacy/compliance guarantees, use a standard TiDB Cloud project and its security controls.

What limits apply?

Instances are disposable with a 72-hour lifespan. Creation is rate-limited (x database creations per IP per hour).

Is 'Instant' really free?

Yes. It's fully sponsored for 72 hours. We believe in the product enough that we think you'll want to keep it.

What happens when I 'Claim' it?

You log in to TiDB Cloud, and we transfer ownership of the instance to your account. It converts to our Starter plan instance

Does it support Vector Search?

Absolutely. It's full featured TiDB under the hood, so you get Vector Search, Full Text Search, and standard SQL all in one.

Rate limits?

x database creations per IP per hour. Don't be greedy, or we'll have to add auth.

INSTANT SQL.BUILT FOR AGENTS.