[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Trestle contact verification](https://spiral.ai/integrations/gemini-cli/trestle-contact-verification)

# How to Use Trestle contact verification in Gemini CLI

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 Gemini CLI

- 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 Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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.

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## 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 Gemini CLI?

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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## 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)
- [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)
- [Hermes](https://spiral.ai/integrations/hermes/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 Gemini CLI guides

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

## Questions about Trestle contact verification in Gemini CLI

**Can Gemini CLI use Trestle contact verification?**

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

**How much does Trestle contact verification cost in Gemini CLI?**

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

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

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 Gemini CLI?**

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

**Does Gemini CLI wait while Trestle contact verification runs?**

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

