Apollo
Arcade tools designed for LLMs to interact with Apollo.io sales intelligence
0.1.0Apollo Toolkit
The Apollo toolkit lets LLMs interact with Apollo.io sales intelligence, enabling account research, lead discovery, and contact enrichment workflows via the Apollo API.
Capabilities
- Company intelligence: Search Apollo's database by firmographic filters and enrich a company domain into detailed account data (industry, size, revenue, funding, location).
- People discovery & enrichment: Search for people by role and employer profile, then enrich individual records with verified contact details using any available identifier (Apollo ID, name, email, or LinkedIn URL).
- Credit-aware results: Enrichment and search operations report
status=insufficient_creditswith graceful degradation rather than hard failures when plan credits are exhausted. - Rate-limit introspection: Retrieve per-endpoint rate limits and remaining request counts to let agents pace batch workloads and avoid throttling.
Secrets
APOLLO_API_KEY — A master API key issued by Apollo.io, required for all toolkit calls. The Apollo.GetApiUsage tool specifically requires the master API key (not a scoped or restricted key). Obtain it from the Apollo.io API Keys settings page (Settings → Integrations → API Keys → Create new key). Ensure the key has the permissions your plan supports; enrichment and search calls consume plan credits tied to the key's account.
See the Arcade secrets guide for how to configure secrets in Arcade, or manage them directly at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(5)
| Tool name | Description | Secrets | |
|---|---|---|---|
Turn a company domain into firmographics (industry, size, revenue, funding,
location) so a rep can qualify and size an account. Consumes one enrichment
credit on a match; when the plan is out of credits the result reports
status=insufficient_credits rather than failing. | 1 | ||
Turn a known person into a verified profile with their current role and,
on request, contact details. Provide at least one identifier: an Apollo person
ID, a name (or first and last name), an email, or a LinkedIn URL; an employer
name or domain alone is not enough to identify someone. Consumes one enrichment
credit on a match; when the plan is out of credits the result reports
status=insufficient_credits rather than failing. | 1 | ||
Report per-endpoint rate limits and how many requests remain, so the agent
can pace a batch of lookups and avoid being throttled. Requires an Apollo
master API key. | 1 | ||
Find companies in Apollo's database that match a firmographic profile so a
rep can prioritize the accounts worth working. Results include firmographics
inline unless include_firmographics is disabled. Company search consumes plan
credits; when the plan is out of credits the result reports
status=insufficient_credits with an empty list rather than failing. | 1 | ||
Find people in Apollo's database by role and the firmographics of their
employer. Returns lightweight records without email or phone; use person
enrichment to reveal verified contact details. | 1 |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
Apollo.EnrichOrganization
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Turn a company domain into firmographics (industry, size, revenue, funding, location) so a rep can qualify and size an account. Consumes one enrichment credit on a match; when the plan is out of credits the result reports status=insufficient_credits rather than failing.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
domain | string | Required | Company domain to look up, such as apollo.io. A full URL or www prefix is accepted and normalized. |
Requirements
Output
json— The matched company, or found=False when no match.Apollo.EnrichPerson
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Turn a known person into a verified profile with their current role and, on request, contact details. Provide at least one identifier: an Apollo person ID, a name (or first and last name), an email, or a LinkedIn URL; an employer name or domain alone is not enough to identify someone. Consumes one enrichment credit on a match; when the plan is out of credits the result reports status=insufficient_credits rather than failing.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
person_id | string | Optional | Apollo person ID, such as the id from a people search result. The most reliable identifier when available. Default is None. |
name | string | Optional | Full name of the person. Default is None. |
first_name | string | Optional | First name, paired with last_name. Default is None. |
last_name | string | Optional | Last name, paired with first_name. Default is None. |
email | string | Optional | Known email address of the person. Default is None. |
organization_name | string | Optional | Employer name to disambiguate a name match. Default is None. |
domain | string | Optional | Employer domain to disambiguate a name match. Default is None. |
linkedin_url | string | Optional | LinkedIn profile URL of the person. Default is None. |
reveal_work_email | boolean | Optional | When True, include the matched person's work email in the result. A successful match consumes an enrichment credit whether or not this is set, so the flag controls only whether the email value is surfaced. Default is False. |
Requirements
Output
json— The matched person, or found=False when no match.Apollo.GetApiUsage
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Report per-endpoint rate limits and how many requests remain, so the agent can pace a batch of lookups and avoid being throttled. Requires an Apollo master API key.
Parameters
No parameters required.
Requirements
Output
json— Per-endpoint rate limits and remaining request counts.Apollo.SearchOrganizations
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Find companies in Apollo's database that match a firmographic profile so a rep can prioritize the accounts worth working. Results include firmographics inline unless include_firmographics is disabled. Company search consumes plan credits; when the plan is out of credits the result reports status=insufficient_credits with an empty list rather than failing.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
keyword_tags | array<string> | Optional | Industry or keyword tags to match, such as fintech or cybersecurity. Default is None. |
locations | array<string> | Optional | Headquarters locations, such as a city, state, or country. Default is None. |
num_employees_ranges | array<string> | Optional | Headcount ranges, each formatted as min,max (for example 51,200). Default is None. |
revenue_min | integer | Optional | Minimum annual revenue in whole dollars. Default is None. |
revenue_max | integer | Optional | Maximum annual revenue in whole dollars. Default is None. |
technology_uids | array<string> | Optional | Apollo technology UIDs the company must use. Default is None. |
include_firmographics | boolean | Optional | When True, backfill each result with firmographics (industry, headcount, location, revenue, founded year) via enrichment so accounts can be ranked without a separate lookup; set False for a faster, lighter name/domain-only list. Default is True. |
limit | integer | Optional | Maximum companies to return, 1 to 100. Default is 25. |
offset | integer | Optional | 0-indexed starting position into the matches. Default is 0 (first result). |
Requirements
Output
json— Matching companies with pagination metadata.Apollo.SearchPeople
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Find people in Apollo's database by role and the firmographics of their employer. Returns lightweight records without email or phone; use person enrichment to reveal verified contact details.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
person_titles | array<string> | Optional | Job titles to match, such as VP of Sales. Matched loosely unless include_similar_titles is disabled. Default is None. |
person_seniorities | array<string> | Optional | Seniority levels of the person's current role. Default is None.ownerfounderc_suitepartnervpheaddirectormanagerseniorentryintern |
person_locations | array<string> | Optional | Locations of the person, such as a city, state, or country. Default is None. |
organization_locations | array<string> | Optional | Locations of the person's employer headquarters. Default is None. |
organization_num_employees_ranges | array<string> | Optional | Employer headcount ranges, each formatted as min,max (for example 51,200). Default is None. |
employer_domains | array<string> | Optional | Company domains the person must work at. Default is None. |
keywords | string | Optional | Free-text keywords matched across the person's profile. Default is None. |
include_similar_titles | boolean | Optional | When True, titles match loosely (similar titles included). Set False to keep only people whose title exactly matches one of person_titles. Default is True. |
limit | integer | Optional | Maximum people to return, 1 to 100. Default is 25. |
offset | integer | Optional | 0-indexed starting position into the matches. Default is 0 (first result). |
Requirements
Output
json— Matching people with pagination metadata.