tidbcloud-http

What problem does it solve?

This Skill solves the limitation of requiring the official @tidbcloud/serverless SDK to query TiDB Serverless, enabling direct raw HTTP access for users who need to bypass the driver or build custom integration workflows with TiDB Cloud.

Core Features & Use Cases

• Direct HTTP Access: Send SQL queries directly to TiDB Serverless's /v1beta/sql endpoint without relying on the official JS SDK or driver.
• Flexible Query Modes: Support for stateless one-off queries, persistent stateful sessions for multi-query workflows, and interactive transactions with configurable isolation levels.
• Automated Handling: Built-in session token management with automatic retry on invalid sessions, in-memory decoding of binary field types (BLOB, BIT, etc.) without extra queries, and a 10,000 row limit to prevent overload.
• Use Case: A DevOps engineer building a custom alerting tool can pull real-time slow query metrics directly from TiDB Serverless via HTTP without integrating the full TiDB Cloud SDK as a project dependency.

Quick Start

Ask the AI to run a stateless SQL query against your TiDB Serverless instance by providing your DATABASE_URL and the target SQL statement to execute via direct HTTP.