Spiral gives your agent every tool with one account. Browse the tools →

Codex · Lead Gen

How to Use Trestle phone number validation in Codex

Check a phone number’s validity, carrier, line type, prepaid status, and activity score. Use it to check a business contact number before a callback or investigate a possible disconnected line.

Prompts to try with Trestle phone number validation in Codex

Copy an example into Codex, or ask in your own words.

Use Trestle phone number validation on +18006927753, then add a result view to this project showing validity, carrier, line type, and activity score.

Trestle phone number validationCodex
Try asking
  • Use Trestle phone number validation on +14089961010 and add the returned carrier and line type to this project’s phone troubleshooting view.

  • Use Trestle phone number validation on +18006927753 and update our importer to keep phone validity separate from activity confidence.

  • Use Trestle phone number validation on +14089961010 and add an explicit insufficient-evidence state when the activity score is 50.

  • Use Trestle phone number validation on +18006927753 and +14089961010, then build a comparison table in this project using their returned phone metadata.

How to set up Trestle phone number validation in Codex

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Trestle phone number validation

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "trestleiq/phones/validate",
        "input": {
          "phone": "<phone>"
        }
      }'

Then paste one of the prompts above: Codex finds Trestle phone number validation on Spiral, shows the price and runs it.

Trestle phone number validation providers and prices

Spiral runs Trestle phone number validation through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
TrestleIQ · Phone validation
trestleiq/phones/validate

What can you do with Trestle phone number validation in Codex?

Build a business phone review into a contact import or callback workflow. A coding agent can turn Trestle’s validity, carrier, line type, and activity results into review states in the project.

Check business callback numbers

Check validity and activity before returning an inbound business inquiry. Keep a valid number with uncertain activity separate from a confirmed formatting problem.

Review imported business contacts

Check the phone numbers in a supplier or partner import and flag invalid entries for correction before the records enter an internal contact system.

Investigate failed business calls

Retrieve carrier, line type, and activity information for a business number associated with failed calls. Use the results to narrow the next troubleshooting step.

Separate business lines by type

Sort business contact numbers by returned line type so an operations team can review mobile, landline, and VoIP destinations separately.

Normalize internal phone records

Use normalized numbers to compare differently formatted entries in an internal business contact list and identify possible duplicates.

Review business contactability

Periodically check supplier and partner phone numbers and send uncertain or low-activity results to an operations review queue.

Audit international contact quality

Compare validation results across business contacts in different countries. Account for Trestle’s country-specific activity evidence when interpreting differences.

Questions about Trestle phone number validation in Codex

Can Codex use Trestle phone number validation?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Trestle phone number validation like any built-in tool.

How much does Trestle phone number validation cost in Codex?

Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

Do I need an Alexandria account to use Trestle phone number validation in Codex?

No. Spiral runs Trestle phone number validation on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up Trestle phone number validation in Codex?

About two minutes: add the hosted server, then sign in.

Does Codex wait while Trestle phone number validation runs?

Trestle phone number validation runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Which countries does Trestle phone validation cover?

Trestle reports coverage across more than 200 countries and territories. Outside the US, activity evidence varies by country, so worldwide coverage does not mean equally detailed activity signals everywhere.

Does a valid result mean the number will answer?

No. Validity checks the number’s structure and carrier assignment; it does not establish that someone will answer. Trestle treats activity as a separate signal.

How much history does the activity score consider?

Trestle evaluates the preceding 12 months of activity data. That makes the score a measure of observed activity over time, rather than proof that a call will connect right now.

What does an activity score of 50 mean?

A score of 50 means Trestle has insufficient signals to classify the line as active or inactive. It should not be read as a 50% probability that someone will answer.

How quickly can carrier information change?

Trestle says it can identify a carrier change within 15 minutes. That statement concerns carrier changes, not a guaranteed refresh interval for every returned attribute.

Get started

Start using Trestle phone number validation in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options