# AX Check: firmadb.com Checked 2026-09-23. Quickstart, docs and pricing are clear, but no session finished 14 of 23 checks pass: quickstart, curl/Python/TS examples, API reference, MCP docs and open EUR pricing (Starter €49 to Scale €399) all present. None of 3 sessions completed. ## End-to-end onboarding not demonstrated ## Coding sessions All three independent sessions (DeepSeek V4 Pro, Kimi K3, Qwen 3.8 Max) did not complete the task, so none reached a pricing verdict or reported running the product end to end. ### DeepSeek V4 Pro [View public run](https://agents.withgauge.com/p/runs/8fee5daa-3fc5-4dd9-8b30-d2ee0b4ac3fd) · [Read transcript](https://www.ax-check.com/firmadb.com/sessions/deepseek.json) #### End-to-end onboarding - **End-to-end onboarding not demonstrated**: The transcript ends mid-session while the agent was still scraping the marketing site and docs (homepage, pricing page, quickstart page) via curl. No account creation, API key retrieval, or authenticated request to FirmaDB's hosted API was attempted or shown before the transcript cuts off. Only static content scraping occurred. Event 22: ```text curl -sL --max-time 20 https://docs.firmadb.com/quickstart/ ``` Event 15: ```text curl -sL --max-time 20 https://firmadb.com/pricing/ ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **Session transcript cuts off before any API signup or call**: The agent spent its visible turns fetching the marketing homepage, pricing page, and docs quickstart page via curl but never reached the sign-up flow, obtained an API key, or made an authenticated call to FirmaDB. This is likely a transcript truncation issue rather than a product defect, but it means no developer workflow was demonstrated as completed. Event 21: ```text curl -sL --max-time 20 https://docs.firmadb.com/quickstart/ 2>&1 | sed 's/ 401 {"type":"https://docs.firmadb.com/errors/unauthenticated/","title":"Missing or invalid API key","status":401,"detail":"Provide a valid API key via the `Authorization: Bearer fdb_*` header."...} ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **No authenticated API call attempted before transcript ends**: The agent located a working demo key in the docs but the transcript cuts off immediately after reading the quickstart page, before any curl or SDK call using that key was executed. This is a session/transcript limitation (incomplete run), not a product defect — the docs make it easy to self-serve a demo key without human intervention. Event 31: ```text copy this read-only demo key and make your first call immediately ``` #### Suggested Changes None identified in this transcript. ### Qwen 3.8 Max [View public run](https://agents.withgauge.com/p/runs/d6dd71a1-8d4d-420f-8468-4d4535e19c3e) · [Read transcript](https://www.ax-check.com/firmadb.com/sessions/qwen.json) #### End-to-end onboarding - **End-to-end onboarding not demonstrated**: Agent installed the real firmadb PyPI package and called the live hosted API (api.firmadb.com) anonymously for health check and countries list, returning real data. But no real API key was ever obtained; client was built with a placeholder string 'fdb_dummy' with a note it wasn't needed for anonymous endpoints. No authenticated operation (needing a valid key, e.g. company lookup or account usage) was shown succeeding, so self-service credential acquisition plus an authenticated operation was not demonstrated. Event 31: ```text client = FirmaDB(api_key="fdb_dummy") # key not needed for anonymous endpoints ``` Event 32: ```text HEALTH: degraded 1.0.0 18 countries, total records: 25,091,739 ``` Event 28: ```text PI_GATEWAY_API_KEY=unused ---env check done--- ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **No real API key available for authenticated endpoints**: The session environment had no FIRMADB_API_KEY or similar credential, so the agent could only exercise anonymous endpoints (health, countries list) using a placeholder key string. Endpoints requiring authentication (company lookup, search, batch enrichment, account usage/pricing) were never actually exercised against the live API. This is a missing-credentials limitation of the test environment, not a demonstrated product defect. Event 28: ```text PI_GATEWAY_API_KEY=unused ---env check done--- ``` Event 31: ```text client = FirmaDB(api_key="fdb_dummy") # key not needed for anonymous endpoints ``` #### Suggested Changes None identified in this transcript. ### Task given to each agent Help me build a simple example using FirmaDB. Tell me how pricing works, and briefly tell me whether this product will be easy for you to manage. Let me know if you get blocked. If this product has no developer workflow you can act on, say so plainly and stop. Stay light: use the hosted product through its SDK or API. Do not start local service stacks or wait for long-running commands; if the quickstart requires either, say so plainly and stop. No product credentials were supplied and no purchases were authorized. ## Score: C · 63/100 (provisional) Grades come from completed site checks. Coding sessions and skipped checks do not affect the score. ### Clarity - **Failed** — Homepage answers Markdown requests ```text Homepage returned text/html for a text/markdown request; no Markdown representation offered. ``` - **Failed** — llms.txt provides an actionable documentation index ```text https://firmadb.com/llms.txt returns HTTP 404; no documentation index exists. ``` - **Skipped** — llms.txt provides navigation guidance ```text llms.txt is 404, so no navigation guidance exists to assess. ``` - **Skipped** — llms.txt mentions offered API, MCP, and skills ```text llms.txt is 404, so no API/MCP/skills mentions exist to assess. ``` - **Skipped** — A compact guide representation exists ```text No site-published Markdown guide fetched; docs and quickstart are HTML only. ``` - **Pass** — A focused guide is directly retrievable ```text Quickstart gives demo key, curl/Python/TS first call and response walkthrough. ``` - **Pass** — Equivalent instructions fit a token budget ```text Quickstart is 2656 tokens, well under the 8000-token guide budget. ``` - **Skipped** — Product-docs links survive format changes ```text Homepage Markdown unsupported, so link preservation across formats cannot be judged. ``` - **Pass** — The compact guide is independently actionable ```text Quickstart gives demo key, curl/Python/TS first call, response fields, and next-step guides. ``` - **Pass** — Install and next-step links resolve ```text Fetched install/next-step links (docs, quickstart, API reference, MCP setup) all returned 200. ``` ### Onboarding - **Pass** — Docs lead to a relevant quickstart ```text Docs quickstart gives goal, demo key, first request, response fields, and next steps. ``` - **Pass** — Installation commands are extractable ```text Quickstart shows export FIRMADB_API_KEY and curl/Python/TypeScript request commands. ``` - **Pass** — Code examples are available without interaction ```text Quickstart includes cURL, Python, and TypeScript examples plus sample JSON response. ``` - **Pass** — Prerequisites and auth boundaries are explicit ```text Quickstart explains demo key, sign-in for own key, and server-side secret handling. ``` ### Pricing - **Pass** — Pricing is readable without interaction ```text Pricing page renders plan names, EUR prices, allowances and overage rates as static text. ``` - **Pass** — Prices are stated, not gated ```text Starter €49, Growth €149, Scale €399 monthly stated openly; only Enterprise is contact-sales. ``` - **Pass** — Pricing units and limits are explicit ```text Plans list included lookups, per-lookup overage, spend caps and rate limits explicitly. ``` - **Skipped** — Agents identify pricing and its assumptions ```text No coding session completed with a pricing verdict, so this behavioural item was not measured. ``` ### Activation - **Pass** — An API reference or OpenAPI spec is reachable ```text API reference page and OpenAPI 3.1 spec at api.firmadb.com/openapi.json both fetched successfully. ``` - **Pass** — An MCP server is documented and well-formed ```text MCP server documented: endpoint, transport, auth, six tools, client configs, troubleshooting. ``` - **Pass** — A CLI install path is documented ```text CLI install documented as brew install firmadb on the API page. ``` - **Skipped** — SDK packages resolve on their registries ```text SDK installs (pip install firmadb, npm i @firmadb/sdk) shown, but no registry lookup result supplied. ``` - **Skipped** — Agent skills are published ```text No agent skills surface is offered or documented in the fetched pages. ``` [Full report data](https://www.ax-check.com/firmadb.com/report.json)