// ai agents and mcp
Via APIWindsurf email verification with pingutil
Cascade can refactor a signup flow or tidy a contacts export, but without a verification tool it treats every well-formed address as good. Adding pingutil to Windsurf's mcp_config.json as a remote Streamable HTTP server gives Cascade the three pingutil tools, with the API key pulled from an environment variable by ${env:...} interpolation.
Where it connects: Windsurf Cascade MCP: mcp_config.json remote entry with serverUrl and headers (${env:...} interpolation)
What goes wrong without it
- Cascade cleaned up our contacts file and kept every address that had an @ in it.
- Our team admin allowlists MCP servers and I need a config that is just a URL and a header.
- I want Cascade to tell me which customer domains are companies and which are Gmail before I build the B2B filter.
What you can do with Windsurf and pingutil
Filter a contacts export with Cascade
Ask Cascade to verify the email column of an export with verify_emails, 50 at a time, and split the file by status into keep, review and drop.
Design a B2B filter from real categories
Have Cascade run lookup_email with fast: true over a sample of customer domains, then write your filter on the category field (company versus free, isp, educational) instead of a hand-made list.
Look up a company before writing integration code
Ask Cascade who is behind a domain; lookup_email returns the company profile so the agent can fill in the record or test fixture you are building.
Set it up
- 1
Create an API key in the pingutil dashboard and set it as PINGUTIL_API_KEY in the environment Windsurf starts from.
- 2
Open the raw MCP config from Windsurf's MCP settings in the Cascade panel rather than guessing the path; Windsurf's docs have used ~/.codeium/windsurf/mcp_config.json and now list a devin config directory, depending on version.
- 3
Add a pingutil entry under mcpServers with serverUrl https://pingutil.com/mcp and an Authorization header of Bearer ${env:PINGUTIL_API_KEY}.
- 4
Save, refresh the MCP server list in Cascade and check that the three pingutil tools appear.
- 5
On a Teams or Enterprise plan, ask your admin to allowlist the server (and, on Enterprise, to turn MCP on) if it does not load.
{
"mcpServers": {
"pingutil": {
"serverUrl": "https://pingutil.com/mcp",
"headers": {
"Authorization": "Bearer ${env:PINGUTIL_API_KEY}"
}
}
}
}What to do with each result
| pingutil result | Action in Windsurf |
|---|---|
| verify_emails: status valid | Keep the row in the cleaned export. |
| status invalid | Move the row to the drop file with its reason. |
| status risky or unknown | Move the row to review; catch-all domains are never confirmed as valid. |
| lookup_email: category company | Count the account as B2B in the filter Cascade writes. |
| lookup_email: category free or isp | Exclude the account from the B2B list, or tag it as personal. |
Limits to plan for
- Windsurf's docs say team admins can restrict MCP to allowlisted servers, and once one server is allowlisted all others are blocked; Enterprise users must turn MCP on in settings.
- Mailbox checks on slow mail servers can take seconds (up to about 25 s), and a 50-address batch waits on the slowest.
- Every call counts toward the key's account limits; on the Free plan that is 300 verifications a day and 3,000 a month, 2,000 lookups a day and 30,000 a month. Auth is the API key in a header, with no OAuth flow.
Windsurf documentation
Windsurf is a trademark of its owner. This integration uses Windsurf's documented extension points; it is not an official Windsurf app.
Common questions
- serverUrl or url?
- Windsurf's remote HTTP example uses serverUrl, so the snippet does too. Other clients such as Cursor use url, which is a common reason a copied config does not load in Windsurf.
- Why do the Windsurf docs mention Devin?
- windsurf.com now redirects to Devin Desktop and the Windsurf Cascade MCP docs are hosted on docs.devin.ai, which is also why newer versions list a devin config directory. The remote server format with serverUrl and headers is the same.
- Does Cascade see my API key?
- Windsurf adds the header when it calls pingutil; Cascade sees tool results. With ${env:PINGUTIL_API_KEY} the key is not stored in the config file either.
- Which tools does the server expose?
- verify_email, verify_emails (up to 50 per call) and lookup_email. All are read-only.
Stop bad addresses in Windsurf today
Sign in with your email, create an API key and paste it into the step above. Test on a few real addresses first: the live demo shows exactly what your Windsurf setup will receive.