Skip to content

// ai agents and mcp

Via API

Windsurf 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. 1

    Create an API key in the pingutil dashboard and set it as PINGUTIL_API_KEY in the environment Windsurf starts from.

  2. 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. 3

    Add a pingutil entry under mcpServers with serverUrl https://pingutil.com/mcp and an Authorization header of Bearer ${env:PINGUTIL_API_KEY}.

  4. 4

    Save, refresh the MCP server list in Cascade and check that the three pingutil tools appear.

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

mcp_config.json
{
  "mcpServers": {
    "pingutil": {
      "serverUrl": "https://pingutil.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PINGUTIL_API_KEY}"
      }
    }
  }
}

What to do with each result

pingutil resultAction in Windsurf
verify_emails: status validKeep the row in the cleaned export.
status invalidMove the row to the drop file with its reason.
status risky or unknownMove the row to review; catch-all domains are never confirmed as valid.
lookup_email: category companyCount the account as B2B in the filter Cascade writes.
lookup_email: category free or ispExclude 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.