MkDocs Email List

// npm install tomba
import { TombaClient, Reveal, Domain, Verifier, Phone } from "tomba";

const client = new TombaClient();
client.setKey("ta_xxxx").setSecret("ts_xxxx");

const reveal = new Reveal(client);
const domain = new Domain(client);
const verifier = new Verifier(client);
const phone = new Phone(client);

// 1. Reveal: find companies for the MkDocs list
const { data } = await reveal.companiesSearch({
  query: "companies using MkDocs",
  page: 1,
});

for (const company of data.companies) {
  // 2. Domain Search: pull live contacts + emails
  const res = await domain.domainSearch({
    domain: company.website_url,
    limit: "20",
  });

  for (const contact of res.data.emails) {
    // 3. Verifier: AI + catch-all verification (accept-all included)
    const check = await verifier.emailVerifier(contact.email);
    if (check.data.email.status !== "valid") continue;

    // 4. Phone Finder: add a direct-dial number (5 credits)
    const dial = await phone.finder({ email: contact.email });
    console.log(contact.email, contact.position, dial.data?.intl_format);
  }
}

// go get github.com/tomba-io/go
package main

import (
	"fmt"
	"os"

	"github.com/tomba-io/go/tomba"
	"github.com/tomba-io/go/tomba/models"
)

func main() {
	client := tomba.New(os.Getenv("TOMBA_API_KEY"), os.Getenv("TOMBA_SECRET_KEY"))

	// 1. Reveal: find companies for the MkDocs list
	companies, err := client.SearchCompanies(&models.RevealSearchRequest{
		Query: "companies using MkDocs",
		Page:  1,
	})
	if err != nil {
		panic(err)
	}

	for _, company := range companies.Data.Companies {
		// 2. Domain Search: pull live contacts + emails
		res, err := client.DomainSearch(tomba.Params{
			"domain": company.WebsiteURL,
			"limit":  20,
		})
		if err != nil {
			continue
		}

		for _, contact := range res.Data.Emails {
			// 3. Verifier: AI + catch-all verification
			check, _ := client.EmailVerifier(tomba.Params{"email": contact.Email})
			if check.Data.Email.Status != "valid" {
				continue
			}

			// 4. Phone Finder: add a direct-dial number (5 credits)
			dial, _ := client.PhoneFinder(tomba.Params{"email": contact.Email})
			fmt.Println(contact.Email, contact.Position, string(dial.Data))
		}
	}
}

# export TOMBA_API_KEY=ta_xxxx TOMBA_SECRET_KEY=ts_xxxx
# 1. Reveal: find companies for the MkDocs list
curl -s -X POST https://api.tomba.io/v1/reveal/search \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "companies using MkDocs", "page": 1}'

# 2. Domain Search: pull live contacts from a company
curl -s "https://api.tomba.io/v1/domain-search?domain=piedpiper.com&limit=20" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

# 3. Verify: AI + catch-all verification (accept-all included)
curl -s "https://api.tomba.io/v1/email-verifier/richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

# 4. Phone Finder: get a direct-dial number for a contact (5 credits)
curl -s "https://api.tomba.io/v1/phone-finder?email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp",
      "headers": {
        "Authorization": "Bearer <base64 of ta_key:ts_secret>"
      }
    }
  }
}