First-party app
Clearout

Clearout

Verify emails (instant and bulk), find professional emails, reverse-lookup people and companies, validate names and resolve domain MX/Whois with Clearout.

stable EmailMarketing

About

Clearout ships in the w6w first-party pack. It declares 27 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.clearout
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Email · Marketing

Overview

Clearout is a data-quality engine for go-to-market workflows: it checks whether an email address will actually be delivered, finds the professional email of a person at a company, and enriches a contact from an email, a LinkedIn profile or a domain.

A workflow can verify a single address in real time (status, safe-to-send, disposable, free, role and gibberish flags, a suggested correction), run one targeted check such as catch-all or business account, or upload a list for bulk verification and poll it to a result file URL. It can find an email from a name and a company, read back a search that timed out and was queued, run the same as a bulk list, look a person up from an email or LinkedIn URL, look a company up from a domain, validate a name for profanity or gibberish, autocomplete a company into domains, and resolve a domain’s MX and Whois records. Account credits, plan and rate limits are readable for free.

The connection holds a Clearout API token (Developer > API in the Clearout dashboard), sent as a bearer token. Verification, finder and lookup calls spend credits; the vendor’s *@example.com test addresses (for example valid@example.com) do not.

Build with Clearout

Three routes to the same 27 actions. The Workflow tab is generated from Clearout's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Cancel Bulk Find

bulk-find-cancel

Cancel a running bulk email finder list.

Get Bulk Find Result URL

bulk-find-download

Request a download URL for the result file of a finished bulk email finder list.

Remove Bulk Find List

bulk-find-remove

Delete a bulk email finder list and its result.

Start Bulk Find

bulk-find-start

Upload a CSV/XLSX of names and company domains for bulk email finding. Returns a list ID to poll with Get Bulk Find Progress. Costs a credit per address found.

Get Bulk Find Progress

bulk-find-status

Read the progress status and percent complete of a bulk email finder list.

Cancel Bulk Verify

bulk-verify-cancel

Cancel a running bulk email verification list.

Get Bulk Verify Result URL

bulk-verify-download

Request a download URL for the result file of a finished bulk email verification list.

Remove Bulk Verify List

bulk-verify-remove

Delete a bulk email verification list and its result.

Start Bulk Verify

bulk-verify-start

Upload a list of emails (or a CSV/XLSX file) for bulk verification. Returns a list ID to poll with Get Bulk Verify Progress. Costs a credit per address.

Get Bulk Verify Progress

bulk-verify-status

Read the progress status and percent complete of a bulk email verification list.

Check Email Attribute

check-email-attribute

Run one targeted check on an address: catch-all domain, disposable, business (work) account, free provider, role account or gibberish. Returns the vendor's result object as is.

Find Domains for Company

find-company-domains

Autocomplete a company name, domain or website URL into matching company domains. Returns the vendor's result as is.

Find Email

find-email

Find a person's professional email address from their name and a company domain or name. Returns candidate addresses with a confidence score. Costs a credit when an address is found.

Get Remaining Credits

get-credits

Read the account's remaining credits, split by pay-as-you-go, subscription and bonus, and the low-balance alert threshold. Free.

Get Find Email Status

get-find-email-status

Read the result of an instant email search that timed out and was queued.

Get Service Limits

get-limits

Read the Email Verifier API rate limit and bulk-verify concurrency limit (total and remaining). Free.

Get Plans and Add-ons

get-plans

Read the account's current plan and add-ons (name, status, type, charge, next credit allocation and renewal dates). Free.

Get Verify Credits and Daily Limit

get-verify-credits

Read available credits plus the daily verify limit and when it resets. Free.

List Bulk Find Lists

list-finder-lists

List bulk email finder lists with their result summaries, with cursor pagination.

List Bulk Verify Lists

list-verify-lists

List bulk email verification lists, newest filters first, with cursor pagination.

Resolve MX

resolve-mx

Find the MX records of a domain. Returns the vendor's result as is.

Resolve Whois

resolve-whois

Find the Whois records of a domain. Returns the vendor's result as is.

Reverse Lookup Domain

reverse-lookup-domain

Find company information (name, LinkedIn page, address) for a domain. Costs a credit when a company is found.

Reverse Lookup Email

reverse-lookup-email

Look up the person behind an email address: name, title, company, LinkedIn profile and location. Costs a credit when a person is found.

Reverse Lookup LinkedIn

reverse-lookup-linkedin

Look up a person from their LinkedIn profile URL: name, title, company and location. Costs a credit when a person is found.

Validate Name

validate-name

Check whether a name string is profane or gibberish.

Verify Email

verify-email

Verify one email address in real time and get its status, whether it is safe to send to, and disposable / free / role / gibberish flags. Costs a credit.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Clearout's real ids.

{
  "manifestVersion": "2",
  "name": "clearout-example",
  "steps": [
    {
      "id": "bulk-find-download",
      "uses": {
        "app": "io.w6w.clearout",
        "action": "bulk-find-download",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "listId": "<listId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Bulk Find Result URL

    perform
    bulk-find-download
  • Start Bulk Find

    perform
    bulk-find-start
  • Get Bulk Find Progress

    read
    bulk-find-status
  • Get Bulk Verify Result URL

    perform
    bulk-verify-download
  • Start Bulk Verify

    perform
    bulk-verify-start

+22 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Clearout, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Clearout. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "bulk-find-download",
  payload: {
    listId: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action bulk-find-download --payload '{"listId":"<value>"}'

Give an AI agent Clearout — without giving it Clearout's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.clearout#bulk-find-download",
    "input": {
      "listId": "<listId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Clearout connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Clearout's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Clearout itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Clearout declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Clearout platform status

dependency

API reachable

Unauthenticated GET /account/credits. Clearout's JSON `failed` envelope with error code 1000 passes: it proves the application is answering.

quota

Credit headroom

Remaining credits vs the account's low-balance threshold, from GET /account/credits.