# MoltSets

> Go-to-market data platform built for AI agents. Valid business and personal emails, carrier-verified mobile phones, and SHA256 hashes for ad audiences, exposed as MCP- and REST-compatible APIs. API and MCP only, currently in closed beta.

MoltSets returns contact and company data an agent can act on directly. Differentiators that affect output quality:

- Every email carries a last-validation date under 30 days.
- Mobile numbers are carrier-validated in real time (mobiles only, no landlines).
- Multi-provider waterfalls maximise coverage on each call.
- One API covers business emails, personal emails, mobile phones, people and company search, reverse lookups, ad-audience identifiers (SHA256 and MAID), email-to-LinkedIn, and IP-to-company.

- App: https://app.moltsets.com - MoltSets: valid business and personal emails, mobile phones, and SHA256's for ads. Get started for free.
- Support docs: https://support.moltsets.com - MoltSets Help Desk articles with information on how to use the MoltSets app, manage billing, manage accounts, and more.
- Developer docs: https://developer.moltsets.com - MoltSets Developer Documentation that includes API reference as well as information on connecting AI agents to the MoltSets MCP.
- Skills library: https://moltsets.com/library - Claude Skills for MoltSets — pre-built, ready to run. Start with identity resolution, enrichment, and more.

## Getting Started
- [Overview](https://developer.moltsets.com/getting-started/overview): What MoltSets is, base URL, request/response structure, plans, and available tools.
- [Authentication](https://developer.moltsets.com/getting-started/authentication): API key format (`ms_XXXXXXXXXXX`), how to create/revoke keys, Bearer token usage, error responses.
- [Rate Limits](https://developer.moltsets.com/getting-started/rate-limits): Per-plan limits, what counts as a request, 429 handling, exponential backoff, multi-key strategies.
- [MoltSets App](https://developer.moltsets.com/getting-started/moltsets-app): Logging in, navigating the app.

## MoltSets' Data
- [Understanding Email Risk Scores](https://developer.moltsets.com/moltsets-data/email-risk-scores): Why third-party validators increasingly mislabel deliverable inboxes as "invalid," and how MoltSets' Email Risk Score (A–F) gives a more accurate send/don't-send signal.
- [Understanding Phone Number Validation](https://developer.moltsets.com/moltsets-data/phone-number-validation): How MoltSets validates mobile numbers and how to weigh the `last_validated_at` date when deciding whether to use a number.
- [Understanding NAICS Codes](https://developer.moltsets.com/moltsets-data/understanding-naics-codes): What NAICS codes are, the 2-to-6-digit hierarchy, and how the `naics_code` filter on `search_companies`/`search_people` matches at any level. Includes all 20 sectors and their subsector tables.
- [Six-Digit NAICS Codes & Titles](https://developer.moltsets.com/moltsets-data/six-digit-naics-codes-titles): The complete six-digit NAICS national industry list (1,012 codes) organized by sector — the most specific level for the `naics_code` filter.

## Use Cases
- [I Have X, I Want Y](https://developer.moltsets.com/use-cases/i-have-x-i-want-y): Tool selection guide — pick based on what data you have (email, HEM, LinkedIn, IP) and what you need. Covers email/people finding, identity resolution, company lookup, IP resolution, search, and chained workflows.
- [Find Companies and Contacts](https://developer.moltsets.com/use-cases/find-companies-and-contacts): Search guide — build prospect lists, look up companies by domain, and find contacts matching an ICP via the MCP or API. Covers filters, pagination, and code examples.

## Best Practices
- [Searching for People](https://developer.moltsets.com/best-practices/searching-for-people): How to build precise people searches with MoltSets — choosing the right filter, avoiding over-filtering on sparse fields, and paginating without burning records.
- [Searching for Companies](https://developer.moltsets.com/best-practices/searching-for-companies): How to qualify accounts with MoltSets — exact domain lookups, choosing an industry vocabulary, and the location caveat that trips up multinational targeting.
- [Getting Valid Emails](https://developer.moltsets.com/best-practices/getting-valid-emails): Which MoltSets email endpoint to call, how to read the risk score before you send, and how to avoid paying for the same lookup twice.
- [Getting Carrier-Verified Mobile Phones](https://developer.moltsets.com/best-practices/getting-carrier-verified-mobile-phones): How to append verified mobile numbers with MoltSets — batching up to 100 profiles per call, budgeting phone tokens, and reading the validation date.
- [Getting Ad Audiences](https://developer.moltsets.com/best-practices/getting-ad-audiences): How to turn MoltSets contacts into privacy-safe advertising audiences — hashed email match keys for customer match, and MAIDs for mobile retargeting.

## Integrations
- [MoltSets MCP Server](https://developer.moltsets.com/integrations/moltsets-mcp): MCP server URL (`https://mcp.moltsets.com/mcp`), setup for Claude.ai, Claude Desktop, and Claude Code, example prompts, troubleshooting.
- [Clay HTTP API](https://developer.moltsets.com/integrations/clay) - Use MoltSets tools directly in Clay via the HTTP API enrichment.

## API reference

Base URL: `https://api.moltsets.com/api/v1/tools/`

Authentication: `Authorization: Bearer YOUR_API_KEY` on every request.

All requests are `POST` with a JSON body. All responses return HTTP 200 with envelope: `{ "results": {...}, "status": "ok", "metadata": { "tokens_used": N, "tokens_remaining": N } }`.

### Search

- [POST /search_people](https://developer.moltsets.com/api-reference/search/search-for-people): Search people by company, industry, size, or revenue → ranked business profiles.
- [POST /search_companies](https://developer.moltsets.com/api-reference/search/search-for-companies): Search companies by name, domain, industry, size, or revenue → ranked company profiles.
- [POST /search_linkedin_profile](https://developer.moltsets.com/api-reference/search/search-for-linkedin-profile): Search a person or company by name + company domain → LinkedIn slug. Use `count_only: true` (free) to check result volume before spending tokens.
- [POST /search_business_email_by_name](https://developer.moltsets.com/api-reference/search/search-business-email-by-name): Name + company domain → valid business email + matched LinkedIn URL. One-call shortcut for `search_linkedin_profile` + `linkedin_to_business_email`. Charged only when found.
- [POST /search_business_profile_by_name](https://developer.moltsets.com/api-reference/search/search-business-profile-by-name): [Advanced] Name + company domain → full business profile (company, title, firmographics).

### Get Valid Emails

- [POST /linkedin_to_best_email](https://developer.moltsets.com/api-reference/get-valid-emails/linkedin-to-best-email): LinkedIn URL → best available email (business preferred, falls back to personal). Returns `type` field (`"business"` or `"personal"`).
- [POST /linkedin_to_business_email](https://developer.moltsets.com/api-reference/get-valid-emails/linkedin-to-business-email): LinkedIn URL → valid business email only.
- [POST /linkedin_to_personal_email](https://developer.moltsets.com/api-reference/get-valid-emails/linkedin-to-personal-email): LinkedIn URL → valid personal email. Not available on the \$997 plan.
- [POST /linkedin_to_best_personal_email](https://developer.moltsets.com/api-reference/get-valid-emails/linkedin-to-best-personal-email): LinkedIn URL → best personal email. Not available on the \$997 plan.

### Get Carrier-Verified Mobile Phones

- [POST /linkedin_to_mobile_phone](https://developer.moltsets.com/api-reference/get-carrier-verified-mobile-phones/linkedin-to-mobile-phone): LinkedIn URL → verified mobile phone (mobiles only, no landlines). Pass `linkedin_url` (single) or `linkedin_urls` (batch, up to 100). Spends 1 phone token per returned result, from your plan's phone token allowance.

### Reverse Lookups

- [POST /reverse_email_lookup](https://developer.moltsets.com/api-reference/reverse-lookups/reverse-email-lookup): Email → full business profile (name, title, seniority, company, LinkedIn, firmographics, emails on file).
- [POST /reverse_linkedin_lookup](https://developer.moltsets.com/api-reference/reverse-lookups/reverse-linkedin-lookup): LinkedIn URL → complete business profile (name, title, seniority, company, industry, revenue, business + personal email). Most complete LinkedIn enrichment.

### Get Ad Audience

- [POST /email_to_maid](https://developer.moltsets.com/api-reference/get-ad-audience/email-to-maid): Email → mobile advertising IDs (MAIDs — AAIDs + IDFAs) for cross-device retargeting.
- [POST /business_email_to_sha256](https://developer.moltsets.com/api-reference/get-ad-audience/business-email-to-sha256): Business email → SHA256 personal hashed emails for audience matching.
- [POST /linkedin_to_sha256](https://developer.moltsets.com/api-reference/get-ad-audience/linkedin-to-sha256): LinkedIn URL → all known SHA256 hashes (business + personal).

### Get LinkedIn

- [POST /email_to_linkedin](https://developer.moltsets.com/api-reference/get-linkedin/email-to-linkedin): Email → highest-confidence LinkedIn profile URL (scores all candidates, returns best full URL).

### Get Company

- [POST /ip_to_company](https://developer.moltsets.com/api-reference/get-company/ip-to-company): IPv4 address → company domain(s) behind the traffic. B2B web-visitor de-anonymisation.

### Account

- [POST /get_account](https://developer.moltsets.com/api-reference/account/get-account): Retrieve account details and credit balance. Free.
- [POST /get_billing](https://developer.moltsets.com/api-reference/account/get-billing): Retrieve billing plan, renewal date, and per-tool credit costs. Free.
- [POST /get_usage](https://developer.moltsets.com/api-reference/account/get-usage): Retrieve credit usage for a time period. Free.

## Plans

| **Plan** | **Lifetime Tokens** | **Rate Limit** | **Phone Tokens** |
| :-- | :-- | :-- | :-- |
| \$0 | 1000 | 1k enrichment records lifetime | 10 |
| \$27 / month | Unlimited | 5k enrichment & 2.5k search records / week | 10 |
| \$97 / month | Unlimited | 75k enrichment & 37.5k search records / week | 50 |
| \$997 | Unlimited | 900k enrichment & 450k search records / week | 250 |

Note: `linkedin_to_personal_email` and `linkedin_to_best_personal_email` are not available on the \$997 plan.

> [Getting the \$997/month plan for \$497/month with the UGC Discount — How It Works](https://support.moltsets.com/en/articles/15207288).

## MCP Server

MCP Server URL: `https://mcp.moltsets.com/mcp`

Connect via Claude Code:
```bash
claude mcp add --transport http moltsets https://mcp.moltsets.com/mcp \
  --client-id YOUR_CLIENT_ID \
  --client-secret YOUR_CLIENT_SECRET
```

Credentials (Client ID + Client Secret) are created at https://app.moltsets.com/dashboard/api_keys.

## More information about MoltSets

- https://moltsets.com/ — Homepage. Unlimited contact data APIs built for Clay and Claude Code, from $27/mo. Enrich your prospect lists with 100% verified contact data. Currently in closed beta — connect your agent and join the closed beta. Beta APIs cover verified business emails, verified personal emails, verified mobile phones, and ad audience identifiers; company search and people search are in alpha.
- https://moltsets.com/pricing — Pricing. Every plan includes unlimited API calls (rate limits vary by plan) and 100% verified emails with a date of last validation under 30 days; real-time carrier-validated mobile numbers. Tiers: Free (1,000 calls), $27/mo (unlimited), $97/mo (unlimited), and the $497/mo UGC plan (50% off the $997 list price, by promo).
- https://moltsets.com/how-it-works — How it works. MoltSets enriches lists in Clay and Claude Code. Sign up and get an API key, try it free or pick an unlimited plan, then connect to Clay or Claude Code. Emails are verified across three sources, mobile numbers are carrier-verified in real time, and only contacts validated in the last 30 days are returned so you never burn tokens on bad data.
- https://moltsets.com/our-data — Our data. The data categories MoltSets covers: 100% verified business emails, personal emails, mobile phones, people search, company search, reverse email lookup, email validation, and Sha256 hashes for ad audiences. Multi-provider waterfalls maximize coverage on every call, and every email carries a validation date under 30 days.
- https://moltsets.com/for-agents — For agents. AI agents can buy MoltSets data with Stripe's MPP or Coinbase's x402 — no API key and no subscription. Create an MPP or x402 wallet, choose the API that fits the task in the docs, then call the MoltSets MCP with the required input; if the wallet has sufficient funds, MoltSets enriches and charges per record. MCP- and REST-compatible, with agent-first docs and transparent pricing.
- https://moltsets.com/partnerships — Partnerships. Partner with MoltSets to lower your data bill, boost your personal brand, and make more money. Three programs: the UGC Plan (50% off, post 2x/mo tagging MoltSets, Adam comments on every post), the Affiliate Program (20% recurring on every dollar from signups you drive), and the Live Show Partner program (demo Claude/Clay skills to 500+ live viewers and get featured in the MoltSets skill library).
- https://moltsets.com/terms-of-service — Terms of Service for MoltSets.
- https://moltsets.com/privacy-policy — Privacy Policy for MoltSets.
- https://moltsets.com/data-protection-addendum - Data Protection Addendum for MoltSets.
- https://moltsets.com/compliance - Compliance information for MoltSets.
- https://moltsets.com/sub-processors-list - Sub-processor information for MoltSets.