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

Codex · Lead Gen

How to Use OrbiSearch email verification in Codex

Returns a deliverability verdict, a specific reason, and mail server and account details for an existing address. Use it to check a business inbox; OrbiSearch work email finder discovers a missing address.

Prompts to try with OrbiSearch email verification in Codex

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

Use OrbiSearch email verification to check [email protected]. Add the returned verdict, reason, and email provider to the project's contact review table.

OrbiSearch email verificationCodex
Try asking
  • Use OrbiSearch email verification to check [email protected]. Build a small local result view showing the returned verdict and explanation.

  • Use OrbiSearch email verification to check [email protected]. Compare the returned email provider and receiving mail server with the values in our local business directory.

  • Use OrbiSearch email verification to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from OrbiSearch email verification and tell me what changed since last week.

How to set up OrbiSearch email verification 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 OrbiSearch email 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": "orbisearch/people/email-verify",
        "input": {
          "email": "<email>"
        }
      }'

Then paste one of the prompts above: Codex finds OrbiSearch email verification on Spiral, shows the price and runs it.

OrbiSearch email verification providers and prices

Spiral runs OrbiSearch email verification through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
OrbiSearch · Email verifier
orbisearch/people/email-verify

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Timeout3 to 97

Seconds OrbiSearch may spend, from 3 to 97. OrbiSearch's default is 97.

Every API field of OrbiSearch · Email verifier is on its tool page: open its card above.

What can you do with OrbiSearch email verification in Codex?

Add deliverability results to a business contact table in your project. An agent can fill missing work addresses or check existing ones, then display OrbiSearch's verdict and supporting details.

Repair incomplete business contact records

Find a missing work address for a public business contact, or check an address already recorded. Attach the returned deliverability result to the record.

Prepare an invited speaker contact sheet

For public business speakers who have agreed to participate, find a missing work email or verify the address supplied. Keep unresolved results visible for the event coordinator.

Review partner contact data

Complete missing addresses for known public business representatives and check existing addresses before an agreed partner update. Summarize the returned results for review.

Add email quality details to an internal tool

Show the deliverability result and email provider beside a business address. Use a discovered address when one is missing, or check the address already present.

Audit public business support inboxes

Check published support or security addresses and report the verdict, reason, and detected email provider. Use the results to review a business contact directory.

Questions about OrbiSearch email verification in Codex

Can Codex use OrbiSearch email verification?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run OrbiSearch email verification like any built-in tool.

How much does OrbiSearch email verification cost in Codex?

$0.003492 per call. 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 OrbiSearch email verification in Codex?

No. Spiral runs OrbiSearch email 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 OrbiSearch email verification in Codex?

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

Does Codex wait while OrbiSearch email verification runs?

OrbiSearch email verification runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

How fresh is OrbiSearch email data?

OrbiSearch documents both finding and validation as checks against live mail servers. These checks do not send an email.

Does a safe result guarantee delivery?

No. OrbiSearch checks whether a mailbox exists and accepts mail at verification time; sender restrictions, content filtering, or later mailbox changes can still prevent delivery.

Can OrbiSearch resolve every catch-all address?

No. Its documentation explicitly says no verification provider can resolve all catch-all addresses, so a catch-all result can remain inconclusive.

What details does OrbiSearch return beyond deliverability?

Its verification enrichment includes flags for disposable addresses, role accounts, and free email providers. A successful work email search includes the same enrichment fields.

What source-side request limit applies?

OrbiSearch documents a shared limit of 20 requests per second per account across its email finder, single verification, and bulk verification submission endpoints.

Get started

Start using OrbiSearch email verification 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