How to Use Trestle contact verification in Claude Code
Returns phone and email contact grades, phone activity and line type, address validity, name matches, and IP trust signals. Use it to assess an incoming business inquiry before choosing a callback, email reply, or manual review.
Prompts to try with Trestle contact verification in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Trestle contact verification for the REI business inquiry in our project fixtures, using its supplied public business contact details. Add the returned phone grade, activity score, and line type to the review screen.
Run Trestle contact verification on the Patagonia business inquiry in our sample data. Show email validity, grade, and inbox deliverability separately in the inquiry component.
Use Trestle contact verification for the Mozilla business record in our inbound inquiry fixture. Update the result parser to retain returned warnings and partial errors.
Check the Powell's Books inquiry fixture with Trestle contact verification. Display address validity and the available name matches without converting null matches into false.
Use Trestle contact verification on the B&H Photo Video business inquiry in our project data. Add a callback review state based on the returned phone activity score and grade.
How to set up Trestle contact verification 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 contact verification
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/contacts/verify", "input": { "name": "<name>", "phone": "<phone>" } }'
Then paste one of the prompts above: Claude Code finds Trestle contact verification on Spiral, shows the price and runs it.
Trestle contact verification providers and prices
Spiral runs Trestle contact verification through Alexandria. Open a card for today's price, with every fee included.
What can you do with Trestle contact verification in Claude Code?
Build an inquiry review screen that shows Trestle phone activity, contact grades, and email deliverability beside each business submission. Preserve warnings and partial errors so reviewers can see which checks completed.
Prioritize business callbacks
Use phone activity scores and contact grades to order callbacks for incoming business inquiries. Review low-activity numbers before assigning a call.
Check a reply channel
Assess the business email supplied with an inbound request. Use inbox deliverability results to decide whether an email reply is likely to reach the supplied address.
Review shared inbox grades
Identify incoming business inquiries whose email grades are low because they use role-based inboxes. Review validity and deliverability alongside the grade before discarding a usable business contact.
Compare inquiry channels
Summarize phone and email grades across incoming business inquiries from different forms or campaigns. Compare the share of active phone numbers and deliverable email addresses.
Review business address discrepancies
Check address validity and available name matches on incoming vendor inquiries. Route invalid addresses and unavailable matches into separate review queues.
Check incomplete verification results
Review returned warnings and partial errors before routing an incoming business inquiry. Keep failed checks visible so an incomplete response does not become an automatic rejection.
More on Trestle contact verification and Claude Code
Overview
Trestle contact verification in other agents
Questions about Trestle contact verification in Claude Code
Can Claude Code use Trestle contact verification?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Trestle contact verification like any built-in tool.
How much does Trestle contact verification 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 contact verification in Claude Code?
No. Spiral runs Trestle contact verification 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 contact verification in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Trestle contact verification runs?
Trestle contact verification runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does Trestle contact verification cover businesses outside the U.S.?
Trestle documents U.S. identity data for Real Contact, including business records. Its global phone validation coverage should not be read as global coverage for Real Contact's identity matches.
How quickly does Trestle reflect changed contact information?
Trestle says carrier changes can appear within 15 minutes, while address changes are generally identified within one month. Freshness depends on the attribute and its underlying sources.
What does the Phone Activity Score tell me?
The score runs from 0 to 100 and estimates whether a number is active. Trestle identifies 70 or higher with consistent activity and 30 or lower with disconnection or inactivity.
Why can a working business email receive a low grade?
Trestle grades role-based inboxes, such as sales or developer addresses, at C or lower even when they are valid. An email contact grade therefore answers a different question from whether that shared inbox can receive mail.
Why might a business contact have a null name match?
Trestle can return null when its identity graph contains only a business name for the phone, email, or address. Its documentation says it avoids matching a person's name against a business name because that can produce incorrect results.
Start using Trestle contact verification 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


