> ## Documentation Index
> Fetch the complete documentation index at: https://developer.moltsets.com/llms.txt
> Use this file to discover all available pages before exploring further.

# I Have X, I Want Y

> Find the right MoltSets tool based on what data you have and what you need. Covers email finding, phone lookup, people finding, and company search.

## Before You Begin

The examples in this guide are designed for use with the MoltSets MCP (Model Context Protocol) server connected to Claude or another AI agent. The "Type in Claude" prompts will only work once your AI tool is connected to MoltSets — without it, Claude has no access to MoltSets tools or your account data.

If you haven't set that up yet, [connect your AI agent to the MoltSets MCP](/integrations/moltsets-mcp) before proceeding.

***

Pick your starting point below. Each table shows what input you need, what you'll get back, an example prompt to use in Claude, and the tool name.

## Search

Search MoltSets's company and contact database by name, domain, industry, employee count, or revenue range. Use these endpoints to build B2B prospect lists, identify target accounts, and find contacts that match your ideal customer profile.

| I have…                                   | I want…                                                           | Type in Claude…                                                    | Tool               |
| ----------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------ | ------------------ |
| Company name                              | Matching company profiles (name, domain, industry, size, revenue) | Find company profiles matching Acme                                | `search_companies` |
| Domain                                    | Exact company record                                              | Look up the company at acme.com                                    | `search_companies` |
| Industry + employee size or revenue range | Filtered list of companies                                        | Find information technology companies with 51-200 employees        | `search_companies` |
| Company name or domain                    | All contacts at that company                                      | Find contacts at acme.com                                          | `search_people`    |
| Company name + industry filter            | Contacts filtered by industry                                     | Find information technology contacts at acme.com                   | `search_people`    |
| Company + seniority                       | Decision-makers at a company                                      | Find senior contacts at acme.com                                   | `search_people`    |
| Industry + country                        | Contacts in an industry and country                               | Find marketing contacts at software companies in the United States | `search_people`    |
| Company + department or function          | Contacts in a specific team                                       | Find engineering contacts at acme.com                              | `search_people`    |

<Note>
  `search_people` filters on `query`, `company`, `company_domain`, `country`, `seniority`, `industry`, `department`, and `functional_area`. It does **not** take `employee_range` or `revenue_range` — those are company filters. To target contacts by company size or revenue, first run `search_companies` with those filters, then `search_people` on each returned domain (see [Common Workflows](#common-workflows)).
</Note>

\| Person name + company domain | LinkedIn slug for that person | Find the LinkedIn profile for John Smith at acme.com | `search_linkedin_profile` |
\| Person name + company domain | Result count before spending tokens | How many people named John Smith are at acme.com | `search_linkedin_profile` (`count_only: true`) |
\| Person name + company domain | Verified business email in one call (plus matched LinkedIn URL) | Find the business email for John Smith at acme.com | `search_business_email_by_name` |
\| Person name + company domain | Full business profile in one call (company, title, firmographics) | Find the business profile for John Smith at acme.com | `search_business_profile_by_name` |

## Get Verified Emails

Resolve LinkedIn profile URLs and company domains into verified business and personal email addresses. Supports single lookups and multi-step chains for building outbound contact lists with high deliverability.

| I have…                      | I want…                                                          | Type in Claude…                                                                                        | Tool                                                        |
| ---------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
| LinkedIn URL                 | Best available email (business if found, falls back to personal) | Find the best email for linkedin.com/in/username                                                       | `linkedin_to_best_email`                                    |
| LinkedIn URL                 | Business email only                                              | Find the business email for linkedin.com/in/username                                                   | `linkedin_to_business_email`                                |
| LinkedIn URL                 | Personal email only                                              | Find the personal email for linkedin.com/in/username                                                   | `linkedin_to_personal_email`                                |
| LinkedIn URL                 | Best personal email                                              | Find the best personal email for linkedin.com/in/username                                              | `linkedin_to_best_personal_email`                           |
| Company name or domain       | Best available email for each employee                           | Search for employees at acme.com and get their best email address                                      | `search_people` → `linkedin_to_best_email`                  |
| Company name or domain       | Business emails for each employee                                | Search for employees at acme.com and get their business email addresses                                | `search_people` → `linkedin_to_business_email`              |
| Company name or domain       | Personal emails for each employee                                | Search for employees at acme.com and get their personal email addresses                                | `search_people` → `linkedin_to_personal_email`              |
| Person name + company domain | Best email for that person                                       | Find John Smith at acme.com and get their best email                                                   | `search_linkedin_profile` → `linkedin_to_best_email`        |
| LinkedIn URL                 | Business email, falling back to personal if not found            | Try to find the business email for linkedin.com/in/username, fall back to personal if nothing is found | `linkedin_to_business_email` → `linkedin_to_personal_email` |

## Get Carrier-Verified Mobile Phones

Look up carrier-verified mobile phone numbers from LinkedIn profiles and company domains. Every number returned is a real mobile device — no landlines or VoIP. Supports single lookups and batches of up to 100 profiles at once, as well as multi-step chains for building call and SMS lists directly from a company name.

| I have…                                 | I want…                                        | Type in Claude…                                                            | Tool                                                   |
| --------------------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------ |
| LinkedIn URL                            | Mobile phone number                            | Find the mobile phone number for linkedin.com/in/username                  | `linkedin_to_mobile_phone`                             |
| List of LinkedIn URLs (up to 100)       | Mobile phone numbers for each profile          | Find mobile phone numbers for these LinkedIn profiles: \[list]             | `linkedin_to_mobile_phone`                             |
| Company name or domain                  | Mobile phone numbers for each employee         | Search for employees at acme.com and get their mobile phone numbers        | `search_people` → `linkedin_to_mobile_phone`           |
| Company name + seniority or role filter | Mobile phones for decision-makers at a company | Search for senior contacts at acme.com and get their mobile phone numbers  | `search_people` → `linkedin_to_mobile_phone`           |
| Person name + company domain            | Mobile phone for that person                   | Find John Smith at acme.com and get their mobile phone number              | `search_linkedin_profile` → `linkedin_to_mobile_phone` |
| LinkedIn URL                            | Email address and mobile phone                 | Get the email address and mobile phone number for linkedin.com/in/username | `linkedin_to_best_email` + `linkedin_to_mobile_phone`  |

## Reverse Lookups

Resolve a single identifier — an email address or a LinkedIn URL — into a complete business profile in one call. Returns name, job title, seniority, company, firmographic data, and emails on file. Use these to enrich inbound leads, form fills, or existing CRM records.

| I have…      | I want…                                                                         | Type in Claude…                                                        | Tool                      |
| ------------ | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------- |
| Email        | Full business profile (name, title, company, firmographics)                     | Look up the business profile for [john@acme.com](mailto:john@acme.com) | `reverse_email_lookup`    |
| LinkedIn URL | Complete profile (title, company, industry, revenue, business + personal email) | Get the full profile for linkedin.com/in/username                      | `reverse_linkedin_lookup` |

## Common Workflows

Some tasks require chaining two tools together. These are the most useful combinations.

### Person name to mobile phone

`search_linkedin_profile` → `linkedin_to_mobile_phone`

You have a person's name and their company domain but no LinkedIn URL. Resolve them to a LinkedIn slug first, then use that to get a mobile phone number.

"Find John Smith at acme.com, then get their mobile phone number."

***

### Company domain to outbound email list

`search_people` → `linkedin_to_best_email`

You have a target company and want a list of contacts with their best email addresses. Search for employees at the company, then enrich each with their best available email.

"Search for employees at acme.com and get their best email address."

***

### Company size or revenue to contact list

`search_companies` → `search_people`

`search_people` can't filter by company size or revenue directly. Find the companies that match those firmographics first, then pull contacts from each matching domain.

"Find computer software companies with 201–500 employees, then get contacts at each one."

***

Not sure where to start? Tell Claude what you have and what you need, and it will pick the right tool automatically.
