Skip to main content
Use Tomba through Corsair: one client, typed API calls. Copy the API key and secret from your Tomba dashboard under API keys. Both are required: the plugin sends them as X-Tomba-Key and X-Tomba-Secret. Set the key as the plugin key and pass the secret as apiSecret, or store both on the account. Things to know:
  • Lookups cost credits. Each call draws on a plan allowance. account.get reports what is left for the current usage window, and account.rateLimits reports the per-route limits.
  • A miss is a success. When no address is found, the finder answers 200 with data.email: null and a score of 0. That is a legitimate answer to check, not an error.
  • A webmail domain is an error. A request against gmail.com fails with 400 and type unknown_record, because Tomba refuses disposable and webmail domains rather than returning nothing.
  • 402 means an empty balance. Nothing is charged and no retry helps. finder.phone costs more than the other lookups.
  • 451 means the person opted out. Tomba withholds their data permanently at their request, so the call is not retried.
  • Rate limits name their window. The 429 message says whether the per-second, per-minute or daily limit was hit, and Retry-After says when to retry. A per-second or per-minute 429 is retried up to three times; a used-up daily limit or count/sources balance is not retried. On the Free plan most lookups allow 5 calls a day per route.
  • Not included. Bulk jobs, lead management, API key management and scraper campaigns have their own routes and are not part of this plugin.
What you get:
  • 22 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Find one person work email
Verify an address
See the full list on the API page.

What’s next

API reference

Every tomba.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.