# AX Check: twilio.com
Checked 2026-09-29.

Twilio docs and quickstart are agent-ready; live pricing page wasn't checked
17 of 23 checklist items pass, including a working quickstart with real commands and code. Pricing page itself was never fetched, so 3 items there are unassessed.

## Onboarding needs a login

## Coding sessions
All three independent sessions (DeepSeek V4.1 Flash, Kimi K3, Qwen 3.8 Max) completed the task and produced pricing breakdowns for SMS and phone numbers, each citing live Twilio pages and stating clear assumptions like US region and pay-as-you-go billing.

### DeepSeek V4.1 Flash
[View public run](https://agents.withgauge.com/p/runs/3209563b-48c7-4427-b462-589e8016eb07) · [Read transcript](https://www.ax-check.com/twilio.com/sessions/deepseek.json)
Pricing table cites real fetched Twilio pages (seq 32/34/41-43) and final output states assumptions: US region, pay-as-you-go plan, per-segment SMS billing, trial $15 credit limit, and notes carrier fees/volume discounts.
#### End-to-end onboarding
- **Onboarding needs a login**: The agent found no Twilio credentials in the sandbox and never obtained real ones. It built the SMS example around fake Account SIDs (e.g. ACfake, ACffffffffffffffffffffffffffffffff), which Twilio correctly rejected with error 20003. This proves the code reaches api.twilio.com but is not an authenticated operation — no real account was used, no authenticated resource (SMS send, account fetch) ever succeeded. The session ended still needing a human to supply real credentials.
  Event 4:

  ```text
  ---ENV---
  ---done---
  ```
  Event 27:

  ```text
  Twilio API error: auth account ACffffffffffffffffffffffffffffffff does not exist
  ```
  Event 75:

  ```text
  I can't send a real SMS because no Twilio credentials are present in this environment.
  ```

#### Hallucinated URLs
- **Guessed phone-number pricing URL returned a 404**: The agent tried https://www.twilio.com/en-us/pricing/phone-numbers, which returned a 'Page not found' Twilio page. This looks like a guessed URL pattern mirroring the working /en-us/sms/pricing/us path rather than a documented link, and the attempt failed. The agent then fell back to /en-us/phone-numbers and /en-us/voice/pricing/us, which worked.
  Event 42:

  ```text
  https://www.twilio.com/en-us/pricing/phone-numbers
  ```
  Event 50:

  ```text
  Page not found | Twilio English
  ```

#### Blockers
- **No Twilio account credentials available in sandbox**: The sandbox had no TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN, and no self-service signup flow was attempted. This is a normal login/credential requirement, not a product defect — the agent correctly identified it, built working example code, and validated the code path against Twilio's live API using fake credentials (producing a clean auth-rejection error), but never completed a real authenticated call such as sending an SMS or fetching real account data.
  Event 4:

  ```text
  ---ENV---
  ---done---
  ```
  Event 27:

  ```text
  Twilio API error: auth account ACffffffffffffffffffffffffffffffff does not exist
  ```

#### Suggested Changes
- **Fix or redirect the guessed phone-number pricing URL**: Requesting https://www.twilio.com/en-us/pricing/phone-numbers returns a 'Page not found' page. If this is a plausible URL pattern users might type or follow from an old link, add a redirect to the correct phone-numbers pricing page (the agent found working pricing info at /en-us/phone-numbers and /en-us/voice/pricing/us). Verify by requesting the URL and confirming it resolves instead of 404ing.
  Event 42:

  ```text
  https://www.twilio.com/en-us/pricing/phone-numbers
  ```
  Event 50:

  ```text
  Page not found | Twilio English
  ```

### Kimi K3
[View public run](https://agents.withgauge.com/p/runs/e26985cc-5708-448e-969e-24b74294c758) · [Read transcript](https://www.ax-check.com/twilio.com/sessions/kimi.json)
Final output gives concrete figures (US SMS ~$0.0079-0.0083/segment, $1.15/mo number, $15 trial credit) each tied to an explicit assumption (region=US, pay-as-you-go, trial vs paid).
#### End-to-end onboarding
- **Onboarding needs a login**: Agent never obtained real Twilio credentials. It installed the SDK, wrote a working script, and confirmed the request path returns a 401 from the live API using deliberately fake dummy credentials — proving connectivity but not an authenticated operation. No account creation or credential retrieval occurred, and none were available in the environment.
  Event 3:

  ```text
  env | grep -iE 'twilio|TWILIO'
  ```
  Event 17:

  ```text
  TwilioRestException - 401 - Unable to fetch record: auth account AC00000000000000000000000000000000 does not exist
  ```
  Event 19:

  ```text
  Creating a Twilio account requires email + phone verification and payment details, which I can't do, and there are no TWILIO_* credentials in this environment.
  ```

#### Hallucinated URLs
None identified in this transcript.

#### Blockers
- **No Twilio account credentials available**: The sandbox had no TWILIO_ACCOUNT_SID or TWILIO_AUTH_TOKEN, and creating a Twilio account requires email/phone verification plus payment details that the agent cannot complete unattended. This is an environment/credential limitation, not a product defect — Twilio normally requires signup like any hosted service.
  Event 3:

  ```text
  env | grep -iE 'twilio|TWILIO' ; echo "---" ; ls /sandbox/repo
  ```
  Event 19:

  ```text
  Creating a Twilio account requires email + phone verification and payment details, which I can't do, and there are no TWILIO_* credentials in this environment.
  ```

#### Suggested Changes
None identified in this transcript.

### Qwen 3.8 Max
[View public run](https://agents.withgauge.com/p/runs/c8ffa6c9-ac64-4d5a-a944-3ea6290a4e87) · [Read transcript](https://www.ax-check.com/twilio.com/sessions/qwen.json)
README/final output gives per-segment SMS/MMS rates, number rental fees, carrier/10DLC fees scraped live (seq 52-59) with explicit assumptions (US region, long code, 1000 msgs/month) and a ballpark total.
#### End-to-end onboarding
- **Onboarding needs a login**: The agent never obtained real Twilio credentials on its own. It found no Twilio env vars in the sandbox, installed the SDK, and wrote a working script, but every live API call used deliberately fake credentials (AC0000... / fake token) purely to confirm the request reached api.twilio.com and was rejected with an auth error. No self-service signup or credential retrieval occurred, and no authenticated operation (like actually sending an SMS) ever succeeded. The agent explicitly states a real account SID/auth token is required and that only the human can create one.
  Event 7:

  ```text
  PI_GATEWAY_API_KEY=<set>
  ```
  Event 35:

  ```text
  Twilio rejected the request (20003): Unable to create record: auth account AC00000000000000000000000000000000 does not exist
  ```
  Event 90:

  ```text
  There are no Twilio credentials in this environment, and Twilio has no offline mode that accepts messages — a real account SID/auth token is the only way past `20003`. Only you can create that.
  ```

#### Hallucinated URLs
- **Guessed pricing URL returned 404 before finding the real one**: The agent tried https://www.twilio.com/en-us/pricing/sms as a guess for the SMS pricing page. It returned a 404, but the agent immediately found the correct page (https://www.twilio.com/en-us/sms/pricing) in the same command, so this looks like an ordinary guess-and-correct rather than a confirmed hallucination causing a stuck failure.
  Event 53:

  ```text
  https://www.twilio.com/en-us/pricing/sms http:404 bytes:612554
  ```

#### Blockers
- **No real Twilio account credentials available to send a live message**: The sandbox environment had no Twilio Account SID or Auth Token, so the agent could only validate the SDK wiring against the live API using intentionally fake credentials (which correctly triggered a 20003 auth error). This is a session/environment limitation (missing human-supplied credentials for a product that requires account signup), not a product defect — Twilio has no way to send messages without real credentials.
  Event 34:

  ```text
  TWILIO_ACCOUNT_SID=AC00000000000000000000000000000000 TWILIO_AUTH_TOKEN=fake_token TWILIO_FROM_NUMBER=+15551234567 TWILIO_TO_NUMBER=+15559876543 python3 send_sms.py "wiring test"; echo "exit=$?"
  ```
  Event 35:

  ```text
  Twilio rejected the request (20003): Unable to create record: auth account AC00000000000000000000000000000000 does not exist
  ```
  Event 90:

  ```text
  I can't actually deliver a message. There are no Twilio credentials in this environment, and Twilio has no offline mode that accepts messages
  ```

#### Suggested Changes
None identified in this transcript.

### Task given to each agent
Help me build a simple example using Twilio. 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: B · 81/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 Markdown Accept header; no Markdown representation served.
  ```

- **Pass** — llms.txt provides an actionable documentation index

  ```text
  llms.txt lists many docs and product pages with descriptive titles, e.g. Voice API and MCP server.
  ```

- **Pass** — llms.txt provides navigation guidance

  ```text
  llms.txt groups links under headings like Voice, Flex, Blog, giving navigational structure.
  ```

- **Pass** — llms.txt mentions offered API, MCP, and skills

  ```text
  llms.txt links Twilio MCP server and Twilio Skills for AI coding agents.
  ```

- **Pass** — A compact guide representation exists

  ```text
  Twilio publishes .md representations of docs pages, e.g. Flex plugin quickstart and MCP/Skills guides.
  ```

- **Pass** — A focused guide is directly retrievable

  ```text
  Flex plugin quickstart .md is directly retrievable with concrete steps, CLI commands and code.
  ```

- **Pass** — Equivalent instructions fit a token budget

  ```text
  Flex quickstart markdown is 4021 tokens, well under the 8000-token budget.
  ```

- **Skipped** — Product-docs links survive format changes

  ```text
  Homepage Markdown is unsupported, so link preservation across formats cannot be measured.
  ```

- **Pass** — The compact guide is independently actionable

  ```text
  Flex plugin quickstart gives concrete steps: create instance, install CLI, run twilio flex:plugins:create, deploy.
  ```

- **Pass** — Install and next-step links resolve

  ```text
  Fetched quickstart and its .md alternate both return 200; next-step links resolve.
  ```


### Onboarding
- **Pass** — Docs lead to a relevant quickstart

  ```text
  Flex quickstart gives concrete steps: create instance, install CLI, build and deploy a plugin.
  ```

- **Pass** — Installation commands are extractable

  ```text
  Quickstart shows extractable commands: twilio login, flex:plugins:create, deploy, release.
  ```

- **Pass** — Code examples are available without interaction

  ```text
  Quickstart includes full React plugin code inline without interaction.
  ```

- **Pass** — Prerequisites and auth boundaries are explicit

  ```text
  Prerequisites list npm, Node LTS, Twilio CLI; login needs Account SID and Auth Token.
  ```


### Pricing
- **Skipped** — Pricing is readable without interaction

  ```text
  No Twilio pricing page was fetched; only changelog notes and homepage nav links to pricing.
  ```

- **Skipped** — Prices are stated, not gated

  ```text
  No Twilio pricing page fetched; changelogs mention past prices, not current gated pricing.
  ```

- **Skipped** — Pricing units and limits are explicit

  ```text
  No Twilio pricing page fetched; changelogs show units but not current pricing limits.
  ```

- **Pass** — Agents identify pricing and its assumptions

  ```text
  3 of 3 sessions were judged on pricing; 0 fell short. DeepSeek V4.1 Flash: Pricing table cites real fetched Twilio pages (seq 32/34/41-43) and final output states assumptions: US region, pay-as-you-go plan, per-segment SMS billing, trial $15 credit limit, and notes carrier fees/volume discounts. Kimi K3: Final output gives concrete figures (US SMS ~$0.0079-0.0083/segment, $1.15/mo number, $15 trial credit) each tied to an explicit assumption (region=US, pay-as-you-go, trial vs paid). Qwen 3.8 Max: README/final output gives per-segment SMS/MMS rates, number rental fees, carrier/10DLC fees scraped live (seq 52-59) with explicit assumptions (US region, long code, 1000 msgs/month) and a ballpark total. This behavioural item does not affect the fast grade.
  ```


### Activation
- **Pass** — An API reference or OpenAPI spec is reachable

  ```text
  Twilio MCP doc indexes public OpenAPI specs; llms.txt links Voice API and Messaging API pages.
  ```

- **Pass** — An MCP server is documented and well-formed

  ```text
  MCP server documented: hosted URL mcp.twilio.com/docs, two tools, no auth, per-IDE setup.
  ```

- **Pass** — A CLI install path is documented

  ```text
  Twilio CLI install path documented; Flex quickstart uses twilio login and flex:plugins commands.
  ```

- **Skipped** — SDK packages resolve on their registries

  ```text
  No registry lookup result for a Twilio SDK package was supplied in the evidence.
  ```

- **Pass** — Agent skills are published

  ```text
  Twilio Skills published on GitHub twilio/ai, installable via Claude, Cursor, Codex, manual copy.
  ```



[Full report data](https://www.ax-check.com/twilio.com/report.json)
