How to Use Trestle phone number validation in Claude Code
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 Claude Code
Copy an example into Claude Code, 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.
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 Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Claude Code 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.
What can you do with Trestle phone number validation in Claude Code?
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.
More on Trestle phone number validation and Claude Code
Overview
Trestle phone number validation in other agents
Questions about Trestle phone number validation in Claude Code
Can Claude Code use Trestle phone number validation?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Trestle phone number validation like any built-in tool.
How much does Trestle phone number validation cost in Claude Code?
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 Claude Code plan is separate.
Do I need an Alexandria account to use Trestle phone number validation in Claude Code?
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 Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Trestle phone number validation runs?
Trestle phone number validation runs in the background. Claude Code 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.
Start using Trestle phone number validation in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


