How to Use Filtrat email verification in Windsurf
Checks an existing email address for mailbox validity, with syntax, disposable-domain and role-address checks. Use it to assess an address you already have; catch-all and risky results require separate judgment.
Prompts to try with Filtrat email verification in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Filtrat email verification for [email protected] and map the mailbox, syntax and role-address checks into our contact model.
Use Filtrat email verification for [email protected] and populate our review table with the returned status and deliverability index.
Use Filtrat email verification to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Filtrat email verification and tell me what changed since last week.
Check Filtrat email verification and summarize what you find in three bullet points.
How to set up Filtrat email verification in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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 Filtrat 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": "filtrat/people/email-verify", "input": { "email": "<email>" } }'
Then paste one of the prompts above: Windsurf finds Filtrat email verification on Spiral, shows the price and runs it.
Filtrat email verification providers and prices
Spiral runs Filtrat email verification through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Skip cache | on or off | off | When true, skip the 180-day result cache and run a fresh check. A cached result is free. Default false. |
| Resolve catchall | on or off | off | When true, resolve a catch-all address to verified or invalid. That answer is 5 vendor credits in all, not on top of the 1-credit check, and only when the resolution is definite. An unresolved catch-all stays free. Default false. |
Every API field of Filtrat · Email verification is on its tool page: open its card above.
What can you do with Filtrat email verification in Windsurf?
Add work-email results to an existing business contact table, with separate columns for uncertain outcomes and receiving-side filtering. A coding agent can map Filtrat responses into the project's contact records and review screens.
Repair an existing business contact record
Find a missing work email from a known company or public LinkedIn profile, or check the address already recorded. Keep unresolved catch-all results separate from confirmed mailboxes.
Prepare a business partnership contact brief
For a public founder or business representative, look up a work address from their name or LinkedIn profile, or assess an address supplied by the partner team.
Review contacts before a B2B event invitation
Complete missing work addresses for existing business relationships and check recorded addresses before preparing invitations. Flag uncertain outcomes for review.
Assess catch-all contacts
Resolve catch-all mailboxes while finding a business address or checking an existing one. Separate confirmed results from addresses Filtrat cannot resolve.
Compare email filtering across business contacts
Use the deliverability index returned with finder and verification results to identify strict receiving domains. Keep mailbox existence and filtering difficulty as separate columns.
Check a public business inbox
Verify a published support or press address and inspect the role-address and mailbox checks before using it for a relevant business inquiry.
More on Filtrat email verification and Windsurf
Overview
Filtrat email verification in other agents
Questions about Filtrat email verification in Windsurf
Can Windsurf use Filtrat email verification?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Filtrat email verification like any built-in tool.
How much does Filtrat email verification cost in Windsurf?
Up to $0.034918 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need an Alexandria account to use Filtrat email verification in Windsurf?
No. Spiral runs Filtrat 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 Filtrat email verification in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Filtrat email verification runs?
Filtrat email verification runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.
Does Filtrat return a newly checked result every time?
No. Verification can reuse a result from the previous 180 days, and finder history can reuse an address found for the same person at the same domain within that period. Request a fresh check when you need a new mailbox test.
Can Filtrat confirm every catch-all address?
No. Catch-all resolution tests a specific mailbox on a domain that accepts arbitrary addresses, but an unresolved address stays catch-all. A finder candidate returned without resolution can also remain unverified.
Does a valid mailbox mean my message will reach the inbox?
Filtrat separates mailbox validity from receiving-side filtering. Its four-level deliverability index can rate an existing mailbox Very Low when an enterprise gateway is likely to block or quarantine unexpected mail.
What makes an email result uncertain?
Filtrat identifies catch-all domains separately because accepting arbitrary addresses does not establish that a particular mailbox exists. Greylisting and limits imposed by the receiving mail server can also produce a risky verification result.
What request limits does Filtrat publish?
Filtrat's direct REST limits are 200 requests per minute for verification and name-and-domain finding, and 100 for LinkedIn finding. These upstream limits apply per account and are counted separately over the last 60 seconds.
Start using Filtrat email verification in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


