Published 2026-09-21 · Tested 2026-08-19

Tinybird

A

Tinybird received 11 PASS votes and passed 5 of five agent surface checks. The clearest finding came from the find the exact limits task.

Panel: GPT 5.6 Sol, Opus 5, DeepSeek v4F Battery: v1 Read as markdown (opens in a new tab)

Three AI models, GPT 5.6 Sol, Claude Opus 5, and DeepSeek v4 Flash, each read Tinybird’s public documentation independently and attempted five first-hour developer jobs: run the CLI quickstart, find the exact limits, recover from query errors, authenticate an endpoint, use the TypeScript SDK.

No accounts, API calls, or code execution were used. Every verdict came from public pages and every published quotation passed a live verification check. Preflight substitutions: T3: Documented query errors replaced HTTP 429 because they provide the clearest recovery path. T4: Endpoint authentication replaced webhooks because the public docs expose no general webhook interface.

Freshness

How rechecks work
Tested
Quotes verified
Surface rechecked

No change since the test.

5 of 5 quoted passages still appear on the live pages.

Tinybird Custom Next.js · published
A

95.0% · 76/80 · AI Agent Readiness Score · reading 30 pts · surface 50 pts

llms.txt PASS
llms-full.txt PASS
markdown mirror PASS
MCP server PASS
docs AI PASS
Task GPT 5.6 SolOpus 5DeepSeek v4F Consensus
Run the CLI quickstart PASSPASSPASS PASS
Find the exact limits PARTIALPARTIALPASS PARTIAL
Recover from query errors PASSPASSPASS PASS
Authenticate an endpoint PARTIALPARTIALPASS PARTIAL
Use the TypeScript SDK PASSPASSPASS PASS

docs platform: Custom Next.js (unscored) · verified 2026-08-19

What to fix first

These 2 fixes could add up to 4 points to the AI Agent Readiness Score. The list ranks each fix by the points it would add. How the ranking works

  1. 1
    +2 points Find the exact limits PARTIAL

    Found: The docs say all limits apply at the organization level, but the limits page gives Copy Pipe quotas per Workspace.

    Fix: State one scope for the Copy Pipe quotas, per Workspace or per organization, on the limits and pricing pages.

    Evidence: www.tinybird.co/docs/forward/pricing/limits (opens in a new tab)

  2. 2
    +2 points Authenticate an endpoint PARTIAL

    Found: The static-tokens scope table maps PIPES:READ to TOKEN APPEND, but the CLI quickstart uses TOKEN READ.

    Fix: In the static-tokens scope table, change the PIPES:READ directive from APPEND to READ.

    Evidence: www.tinybird.co/docs/forward/core-concepts/static-tokens (opens in a new tab)

What the docs get right

  • Run the CLI quickstart: 3 PASS votes. One quickstart defines page_views, ingests three events, queries top_pages, and deploys with tb deploy.
  • Recover from query errors: 3 PASS votes. The common-patterns page names both codes and pairs each with causes and a Solutions list.
  • 5 of 5 agent surface checks. Present: llms.txt, llms-full.txt, markdown mirrors, an MCP server, docs AI.

Run the CLI quickstart

PASS

PASS consensus from 3 PASS.

One quickstart defines page_views, ingests three events, queries top_pages, and deploys with tb deploy. One linear path gives the install command, the complete page_views.datasource and top_pages.pipe file bodies, tb build, a working Events API curl with three sample rows, the query call, the expected JSON response, and tb deploy, with no step left to inference. The quickstart walks through install, project init, datasource creation, endpoint creation, build, data ingest via Events API, curl query, and deploy with unambiguous step-by-step commands and file examples.

Find the exact limits

PARTIAL

PARTIAL consensus from 1 PASS, 2 PARTIAL.

The values are 250 per IP per region and 20, 100, and 200 per workspace, but pricing says all limits are organization-wide. Every value is exact and on one page (250 concurrent connections per IP per region; Copy Pipes 20 Free, 100 Developer, 200 Enterprise), but the scope contradicts itself: the page opens by stating all limits are organization-level and shared across workspaces, while the Copy Pipe table states the same quotas are per Workspace. The concurrent connection limit and Free (20), Developer (100), and Enterprise (200) Copy Pipe quotas are tabulated clearly per plan with active-job, execution-time, and frequency columns.

Recover from query errors

PASS

PASS consensus from 3 PASS.

The common-patterns page names both codes and pairs each with causes and a Solutions list. Both codes get a named section with a cause list and a solution list on a single page, and the API Endpoints page closes the loop by documenting the X-DB-Exception-Code response header that surfaces the numeric code in the first place. Both error codes 241 and 252 have dedicated entries on the common-error-patterns page and full dedicated sub-pages with causes, example errors, fixes, and Tinybird-specific debugging notes.

Authenticate an endpoint

PARTIAL

PARTIAL consensus from 1 PASS, 2 PARTIAL.

The full static-token path is documented, but its PIPES:READ table says TOKEN APPEND while the quickstart says TOKEN READ. All four stages are documented end to end, but the static-token scope reference table maps PIPES:READ:pipe_name to "TOKEN <token_name> APPEND in .pipe files", contradicting the working example directly below it on the same page and the CLI quickstart, both of which use READ. The docs cover both static tokens (resource-scoped via TOKEN directive in datafiles, workspace-level via CLI) and JWTs (payload creation, signing, scopes, expiration, rate limits). Storage and transmission are documented for CLI, SDK, CI/CD, and raw API contexts.

Use the TypeScript SDK

PASS

PASS consensus from 3 PASS.

The SDK quickstart covers initialization, definitions, build, ingest, query, and deploy while preserving the CLI resource names. The SDK quickstart mirrors the CLI quickstart step for step on the identical page_views and top_pages example, so defineDatasource, defineEndpoint, npx tinybird build, ingest, and query map one to one onto the datafile concepts. The TypeScript SDK quickstart mirrors the CLI workflow exactly: same datasource/endpoint names (page_views, top_pages), same build/ingest/query pattern, same branch-based iteration with materialized views. The typed client provides a direct conceptual mapping from CLI datafiles to SDK resources.

The receipt

250 active connections from the same IP address per region

The values are 250 per IP per region and 20, 100, and 200 per workspace, but pricing says all limits are organization-wide.

Agent surface notes

Initialize returned JSON-RPC protocol 2025-06-18 and Tinybird server information.

The live docs expose a public Ask AI control.

Show the score

AI Agent Readiness Score 95.0%, grade A

Paste this into a readme:

[![AI Agent Readiness Score 95.0%](https://docsforagents.com/badge/tinybird.svg)](https://docsforagents.com/reports/tinybird-docs-ai-agent-readiness/)

Method note

This is a reading test of public documentation, not an execution test. No accounts were created and no API calls were run. The AI Agent Readiness Score counts fifteen reading votes at PASS 2, PARTIAL 1, and FAIL 0, for 30 possible points. Five agent surface checks add 10 points each. The total is 80. Consensus chips show each row majority and do not affect scoring. The panel split on 2 of five tasks. Quotes shown here were re-fetched and confirmed verbatim on 2026-08-19.

Read the full methodology

Put another docs site through the battery.

Nominate a docs site