MoltSets resolves most contact data — emails, phone numbers, et al. — from its own database. For some requests, the data you're looking for isn't in that database, and MoltSets will make a call to a third-party data source to try to find it. Those calls cost external tokens.

External tokens exist separately from your regular credit balance. They're specifically for lookups that can't be resolved in-house — the goal is to maximise coverage so you're not getting empty results simply because a contact falls outside MoltSets' native database.

When you make a request, MoltSets checks its own data first. If a result is found, it returns normally. If not, and an external source might help, MoltSets uses an external token to attempt that lookup. Tokens are only consumed when a third-party call actually happens, not on every request and not when no data is found.

Mobile phone data is sourced live on each lookup, so results reflect the most up-to-date number available rather than a cached match.

External token use is on by default. You can toggle it globally from your dashboard, or override it for any individual API or MCP call by passing use_external_tokens: false. A per-call setting always takes precedence over your dashboard default. When external tokens are turned off (globally or per call), MoltSets only returns what it can resolve from its own database — it won't fall back to a third-party lookup.

Gifted external tokens (the ones included with your subscription at no extra charge) roll over at the end of the month if you don't use them, but they expire at the end of the following month. This gives each gifted token a lifespan of up to 60 days.

Each month, tokens are consumed in this order: rolled-over gifted tokens first, then the current month's allocation, and finally any purchased tokens. This means gifted tokens are used up before they have a chance to expire wherever possible.

Purchased external tokens do not expire. They roll over and remain available for as long as your account is active.

If you cancel your subscription, any remaining external tokens, gifted or purchased, are removed from your account.

Your external token allocation depends on your plan:

The number of external tokens used is dependent on the data requested and whether or not MoltSets has the informational internally for a given record.

External credits can be purchased ad hoc on the Billing page of the dashboard at the following rates: