[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Trestle contact verification](https://spiral.ai/integrations/hermes/trestle-contact-verification)

# How to Use Trestle contact verification in Hermes

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.

|  |  |
| --- | --- |
| Model | Trestle contact verification |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.17459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Trestle contact verification in Hermes

- Each morning, use Trestle contact verification on new REI business inquiries and their supplied public business contact details. Summarize phone grades and activity scores for callback review.
- Every weekday, check newly received Patagonia business inquiries with Trestle contact verification, including inbox deliverability. Report valid shared inboxes separately from inboxes that cannot receive mail.
- Each afternoon, use Trestle contact verification on new Mozilla business inquiries. Produce a count of completed checks, warnings, and incomplete results.
- Each morning, check new Powell's Books business inquiries with Trestle contact verification. Summarize address validity and keep unavailable name matches separate from mismatches.
- Every Friday, use Trestle contact verification on new B&H Photo Video business inquiries awaiting a reply. Summarize phone grades, email grades, and inbox deliverability for the review queue.

## How to set up Trestle contact verification in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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 Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Trestle contact verification**: One request; the result comes back by polling or a webhook.

```bash
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: Hermes finds Trestle contact verification on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/hermes

## Trestle contact verification tools and prices

- [TrestleIQ · Real contact](https://spiral.ai/tools/alexandria/trestleiq/contacts/verify) (Alexandria): Up to $0.17459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| email |  | — | Email to grade. Optional on this route. Example john.doe@example.com. |
| add_ons |  | — | Comma-separated add-ons: email_checks_deliverability, email_checks_age, litigator_checks. Each is an extra $0.005. |
| last_name |  | — | Family name. Example Doe. |
| first_name |  | — | Given name. Example John. |
| ip_address |  | — | IPv4 or IPv6 captured with the lead. Example 192.0.0.1. |
| address.city |  | — | City. Example Lynden. |

## What can you do with Trestle contact verification in Hermes?

Prepare a daily callback review queue from new business inquiries using Trestle phone grades and activity scores. Summarize email deliverability and incomplete checks so the team can choose a reply channel.

### 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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Hermes guides](https://spiral.ai/integrations/hermes)

## Trestle contact verification in other agents

- [Amp](https://spiral.ai/integrations/amp/trestle-contact-verification)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/trestle-contact-verification)
- [Claude](https://spiral.ai/integrations/claude-desktop/trestle-contact-verification)
- [Claude Code](https://spiral.ai/integrations/claude-code/trestle-contact-verification)
- [Cline](https://spiral.ai/integrations/cline/trestle-contact-verification)
- [Codex](https://spiral.ai/integrations/codex/trestle-contact-verification)
- [Cursor](https://spiral.ai/integrations/cursor/trestle-contact-verification)
- [Devin](https://spiral.ai/integrations/devin/trestle-contact-verification)
- [dots](https://spiral.ai/integrations/dots/trestle-contact-verification)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/trestle-contact-verification)
- [Gemini](https://spiral.ai/integrations/gemini/trestle-contact-verification)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/trestle-contact-verification)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/trestle-contact-verification)
- [goose](https://spiral.ai/integrations/goose/trestle-contact-verification)
- [Grok](https://spiral.ai/integrations/grok/trestle-contact-verification)
- [Grok Build](https://spiral.ai/integrations/grok-build/trestle-contact-verification)
- [Instinct](https://spiral.ai/integrations/instinct/trestle-contact-verification)
- [Manus](https://spiral.ai/integrations/manus/trestle-contact-verification)
- [Muse](https://spiral.ai/integrations/muse/trestle-contact-verification)
- [Muse Code](https://spiral.ai/integrations/muse-code/trestle-contact-verification)
- [n8n](https://spiral.ai/integrations/n8n/trestle-contact-verification)
- [Notion](https://spiral.ai/integrations/notion/trestle-contact-verification)
- [OpenClaw](https://spiral.ai/integrations/openclaw/trestle-contact-verification)
- [opencode](https://spiral.ai/integrations/opencode/trestle-contact-verification)
- [Perplexity](https://spiral.ai/integrations/perplexity/trestle-contact-verification)
- [Raycast](https://spiral.ai/integrations/raycast/trestle-contact-verification)
- [VS Code](https://spiral.ai/integrations/vscode/trestle-contact-verification)
- [Windsurf](https://spiral.ai/integrations/windsurf/trestle-contact-verification)
- [Zapier](https://spiral.ai/integrations/zapier/trestle-contact-verification)

## More Hermes guides

- [Trade.gov screening record](https://spiral.ai/integrations/hermes/trade-gov-screening-record)
- [Trestle phone number validation](https://spiral.ai/integrations/hermes/trestle-phone-number-validation)
- [Trade.gov screening list records](https://spiral.ai/integrations/hermes/trade-gov-screening-list-records)
- [U.S. House representative profile](https://spiral.ai/integrations/hermes/u-s-house-representative-profile)
- [Trade.gov screening list publication status](https://spiral.ai/integrations/hermes/trade-gov-screening-list-publication-status)
- [U.S. House representative roster](https://spiral.ai/integrations/hermes/u-s-house-representative-roster)

## Questions about Trestle contact verification in Hermes

**Can Hermes use Trestle contact verification?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Trestle contact verification like any built-in tool.

**How much does Trestle contact verification cost in Hermes?**

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 Hermes plan is separate.

**Do I need an Alexandria account to use Trestle contact verification in Hermes?**

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 Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while Trestle contact verification runs?**

Trestle contact verification runs in the background. Hermes 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.

