Integration

RevenueBase integration

RevenueBase is a B2B contact and company dataset with email verification. An agent can size an audience for free (counts, insights, a masked sample), retrieve contacts or companies by filter or by known identifiers, find look-alike companies, export files, verify one email or upload a list, and read the credit balance and prices. Contact rows (names, job titles, emails, mobile numbers) are personal data. Retrieval, look-alikes and exports spend credits on Pay-as-you-go (1 per row, +1 per revealed email, +10 per revealed mobile, +10 per SmartSearch node) and are included on All-you-can-eat; email verification costs 1 credit per Valid or Invalid result on every plan. Contact and company routes share 10 requests per second per user. Left out: API key rotation (it would invalidate the stored key), the health check, the deprecated contact lookalike and legacy title-match routes, and the audience-from-text route the reference does not document. Authentication: the Production API Key from the RevenueBase dashboard (Developers), sent in an x-key header.

Connect RevenueBase How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in RevenueBase.Built from the 34 RevenueBase tools below, on the connection you add once.

What you can do with RevenueBase

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Email verification batch, 5 operations

cancel_email_batchCancel email batchPOSTAgents: ask firstCancels a queued or running email verification batch (free); it moves to CANCELLING. Results already verified Valid or Invalid stay billed. Poll get_email_batch until CANCELLED.
get_email_batchGet email batchGETAgents: ask firstReturns the processing state of an email verification batch by process_id, with a progress or error message. Free; poll every 5 to 10 seconds until COMPLETED, CANCELLED or ERROR.
list_active_email_batchesList active email batchesGETAgents: ask firstLists the account's email verification batches still QUEUED or PROCESSING, with process_id, file name, message and counters, 10 per page by default. Free.
list_email_batchesList email batchesGETAgents: ask firstLists all the account's email verification batches in every state, optionally one status only, with process_id, counters and credits used, 10 per page by default. Free.
upload_email_verification_batchUpload email verification batchPOSTAgents: ask firstUploads a .csv or .json file with an email field for background verification and returns a numeric process_id; poll get_email_batch. Costs 1 credit per Valid or Invalid result as it runs.

Company export, 4 operations

cancel_company_exportCancel company exportDELETEAgents: ask firstAsks to cancel an unfinished company export (free); it moves to CANCELLING, then ends. Poll get_company_export until CANCELLED. A completed export is not refunded.
estimate_company_exportEstimate company exportPOSTAgents: ask firstForecasts the credits of a company export for free, with no hold and no job. Send the filter, columns and maxRows you plan to give start_company_export. creditsEstimate is null when exports are not metered.
get_company_exportGet company exportGETAgents: ask firstReturns the state of a company export by exportId and, once COMPLETED, a signed downloadUrl (valid about an hour). Free; poll every 5 to 10 seconds until COMPLETED, ERROR or CANCELLED.
start_company_exportStart company exportPOSTAgents: ask firstStarts a background company file export (one row per company) and returns its exportId; follow it with get_company_export. Spends 1 credit per written row plus 10 per SmartSearch node on Pay-as-you-go. maxRows is required.

Contact export, 4 operations

cancel_contact_exportCancel contact exportDELETEAgents: ask firstAsks to cancel an unfinished contact export (free); it moves to CANCELLING, then ends. Poll get_contact_export until CANCELLED. A completed export keeps its state and is not refunded.
estimate_contact_exportEstimate contact exportPOSTAgents: ask firstForecasts the credits of a contact export for free, with no hold and no job. Send the filter, columns, maxRows and reveal you plan to give start_contact_export. creditsEstimate is null when exports are not metered.
get_contact_exportGet contact exportGETAgents: ask firstReturns the state of a contact export by exportId and, once COMPLETED, a signed downloadUrl (valid about an hour) to the file of contacts (personal data). Free; poll every 5 to 10 seconds until COMPLETED, ERROR or CANCELLED.
start_contact_exportStart contact exportPOSTAgents: ask firstStarts a background contact file export (personal data) and returns its exportId; follow it with get_contact_export. Spends credits on Pay-as-you-go: 1 per row, +1 per email, +10 per mobile. maxRows and reveal are required.

Column, 2 operations

list_company_columnsList company columnsGETAgents: ask firstLists the company fields usable in filters and columns, with types and which ones have a fixed value list; include=values embeds those value lists. Free.
list_contact_columnsList contact columnsGETAgents: ask firstLists the person, job and company fields of contact records usable in filters and columns, with types and which ones have a fixed value list; include=values embeds those value lists. Free.

Column value, 2 operations

list_company_column_valuesList company column valuesGETAgents: ask firstReturns the values of one field that has a fixed value list (for filter conditions), optionally narrowed by search. Free. Open-ended fields such as job titles answer 422.
list_contact_column_valuesList contact column valuesGETAgents: ask firstReturns the values of one field that has a fixed value list (for filter conditions), optionally narrowed by search. Free. Open-ended fields such as job titles answer 422.

Company, 2 operations

lookup_companiesLookup companiesPOSTAgents: ask firstRetrieves stored company records by domain, company LinkedIn URL or RBID_ORG, up to 10,000 combined (a dataset lookup: nothing is fetched live). Spends 1 credit per returned match on Pay-as-you-go (0 on All-you-can-eat).
preview_companiesPreview companiesPOSTAgents: ask firstReturns companies matching a company filter right away, one row per company (RBID_ORG). On Pay-as-you-go it uses the shared 500 free preview rows per day, no credits; limit is required.

Contact, 2 operations

lookup_contactsLookup contactsPOSTAgents: ask firstRetrieves known contacts by email address or RBID_PAO person id, up to 10,000 combined (personal data). Spends credits on Pay-as-you-go: 1 per match, +1 per revealed email, +10 per mobile. reveal is required.
preview_contactsPreview contactsPOSTAgents: ask firstRetrieves contacts matching a filter right away (personal data: names, roles, emails, mobiles). Spends credits on Pay-as-you-go: 1 per row, +1 per revealed email, +10 per mobile. limit and reveal are required.

Company audience, 1 operation

count_companiesCount companiesPOSTAgents: ask firstCounts the companies matching a filter, with the contact rows at those companies and how many have an email or a mobile. Free (0 credits, SmartSearch included).

Company dataset, 1 operation

get_company_dataset_statsGet company dataset statsGETAgents: ask firstReturns whole-dataset company totals: companies, how many have a domain, a LinkedIn URL or an about-us text, and the contact rows they hold. Free; takes no filter.

Company insights, 1 operation

get_company_insightsGet company insightsPOSTAgents: ask firstAnalyzes a company audience for free, one section per call: coverage (companies grouped by a field, by employee range by default) or fillRate (how often company fields are filled).

Contact audience, 1 operation

count_contactsCount contactsPOSTAgents: ask firstCounts the contact rows matching an audience filter, with distinct companies and how many have an email or a mobile. Free (0 credits, SmartSearch included); returns numbers, never contacts.

Contact dataset, 1 operation

get_contact_dataset_statsGet contact dataset statsGETAgents: ask firstReturns whole-dataset totals: contact rows and distinct companies. Free; takes no filter (count_contacts counts an audience).

Contact insights, 1 operation

get_contact_insightsGet contact insightsPOSTAgents: ask firstAnalyzes a contact audience for free, one section per call: reachability (email and mobile availability), freshness, coverage (grouped by a field) or fillRate (how often fields are filled). Aggregates only.

Contact sample, 1 operation

get_contact_sampleGet contact samplePOSTAgents: ask firstReturns a free masked sample of up to 100 contacts matching a filter (names, roles, company fields; email and mobile replaced by hasEmail and hasMobile). Personal data. Uses the daily free preview rows.

Credit balance, 1 operation

get_account_balanceGet account balanceGETAgents: ask firstReturns the account's remaining credit balance. Free; read it before a paid retrieval or verification and again after one.

Credit price, 1 operation

get_credit_pricesGet credit pricesGETAgents: ask firstReturns the current Pay-as-you-go credit rates for retrieval: per contact row, company row, revealed email, revealed mobile and SmartSearch node. Free; it is not an entitlement lookup.

Email verification, 1 operation

validate_emailValidate emailPOSTAgents: ask firstVerifies one email address (personal data) and returns Valid, Invalid or Unknown. Costs 1 credit per Valid or Invalid result on every plan (Unknown is free). metadata=true adds provider, MX and reason details at no cost.

Email verification result, 1 operation

download_email_batch_resultsDownload email batch resultsGETAgents: ask firstDownloads the result file of a COMPLETED (or partially, a CANCELLED) email verification batch as a stored file in the upload's format, each row with its status. Free; may contain personal data.

Lookalike company, 1 operation

find_lookalike_companiesFind lookalike companiesPOSTAgents: ask firstFinds the companies most similar to a seed company (domain or rbidOrg), nearest first with a similarity score. Spends credits on Pay-as-you-go: 1 per returned company plus 10 per call. limit is required.

Match preset, 1 operation

list_match_presetsList match presetsGETAgents: ask firstLists the SmartSearch match presets (exact, similar, related, broad) with their thresholds for job-title, company-description and lookalike filter nodes, and the recommended one. Free.

Use RevenueBase from Claude Code, Cursor or Codex

Connect RevenueBase in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its RevenueBase operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect RevenueBase

Create your workspace
Sign up free. Nothing to install.
Connect RevenueBase once
Add your RevenueBase connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.