Can I use Apollo.io as a CLI?

Yes. KosmoKrator exposes a Apollo.io CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Apollo.io through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Apollo.io tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Apollo.io credentials stored?

Apollo.io credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Apollo.io MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Apollo.io CLI for AI Agents

Use the Apollo.io CLI from KosmoKrator to call Apollo.io tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Apollo.io CLI Setup

Apollo.io can be configured headlessly with `kosmokrator integrations:configure apollo`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure apollo --set api_key="$APOLLO_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor apollo --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`APOLLO_API_KEY`	Secret `secret`	yes	API Key
`url`	`APOLLO_URL`	URL `url`	no	Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call apollo.apollo_search_people '{}' --json

Provider shortcut

kosmo integrations:apollo apollo_search_people '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs apollo --json
kosmo integrations:docs apollo.apollo_search_people --json
kosmo integrations:schema apollo.apollo_search_people --json
kosmo integrations:search "Apollo.io" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`apollo.apollo_search_people`

Search net-new people in Apollo data.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_search_people '{}' --json

Shortcut

kosmo integrations:apollo apollo_search_people '{}' --json

`apollo.apollo_enrich`

Enrich one person by email, name, ID, LinkedIn URL, or company attributes.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_enrich '{}' --json

Shortcut

kosmo integrations:apollo apollo_enrich '{}' --json

`apollo.apollo_bulk_enrich_people`

Enrich up to 10 people in a single Apollo request.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_bulk_enrich_people '{}' --json

Shortcut

kosmo integrations:apollo apollo_bulk_enrich_people '{}' --json

`apollo.apollo_list_organizations`

Search companies in Apollo data.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_organizations '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_organizations '{}' --json

`apollo.apollo_enrich_organization`

Enrich one company by domain.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_enrich_organization '{}' --json

Shortcut

kosmo integrations:apollo apollo_enrich_organization '{}' --json

`apollo.apollo_bulk_enrich_organizations`

Enrich up to 10 companies by domain.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_bulk_enrich_organizations '{}' --json

Shortcut

kosmo integrations:apollo apollo_bulk_enrich_organizations '{}' --json

`apollo.apollo_list_organization_job_postings`

List current job postings for an Apollo organization.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_organization_job_postings '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_organization_job_postings '{}' --json

`apollo.apollo_search_contacts`

Search saved contacts in your Apollo team account.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_search_contacts '{}' --json

Shortcut

kosmo integrations:apollo apollo_search_contacts '{}' --json

`apollo.apollo_get_contact`

View a saved Apollo contact by contact ID.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_get_contact '{}' --json

Shortcut

kosmo integrations:apollo apollo_get_contact '{}' --json

`apollo.apollo_create_contact`

Create a saved Apollo contact.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_create_contact '{}' --json

Shortcut

kosmo integrations:apollo apollo_create_contact '{}' --json

`apollo.apollo_update_contact`

Update a saved Apollo contact.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_update_contact '{}' --json

Shortcut

kosmo integrations:apollo apollo_update_contact '{}' --json

`apollo.apollo_bulk_create_contacts`

Create up to 100 Apollo contacts in one request.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_bulk_create_contacts '{}' --json

Shortcut

kosmo integrations:apollo apollo_bulk_create_contacts '{}' --json

`apollo.apollo_list_contact_stages`

List Apollo contact stage IDs.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_contact_stages '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_contact_stages '{}' --json

`apollo.apollo_search_accounts`

Search saved accounts in your Apollo team account.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_search_accounts '{}' --json

Shortcut

kosmo integrations:apollo apollo_search_accounts '{}' --json

`apollo.apollo_get_organization`

View a saved Apollo account by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_get_organization '{}' --json

Shortcut

kosmo integrations:apollo apollo_get_organization '{}' --json

`apollo.apollo_create_account`

Create a saved Apollo account.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_create_account '{}' --json

Shortcut

kosmo integrations:apollo apollo_create_account '{}' --json

`apollo.apollo_update_account`

Update a saved Apollo account.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_update_account '{}' --json

Shortcut

kosmo integrations:apollo apollo_update_account '{}' --json

`apollo.apollo_bulk_create_accounts`

Create up to 100 Apollo accounts in one request.

Write write

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_bulk_create_accounts '{}' --json

Shortcut

kosmo integrations:apollo apollo_bulk_create_accounts '{}' --json

`apollo.apollo_list_account_stages`

List Apollo account stage IDs.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_account_stages '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_account_stages '{}' --json

`apollo.apollo_get_current_user`

Get the authenticated Apollo user profile when available.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_get_current_user '{}' --json

Shortcut

kosmo integrations:apollo apollo_get_current_user '{}' --json

`apollo.apollo_list_users`

List Apollo team users.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_users '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_users '{}' --json

`apollo.apollo_list_email_accounts`

List Apollo email accounts.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_list_email_accounts '{}' --json

Shortcut

kosmo integrations:apollo apollo_list_email_accounts '{}' --json

`apollo.apollo_get_api_usage_stats`

View Apollo API usage and rate-limit statistics.

Read read

Parameters: none

Generic call

kosmo integrations:call apollo.apollo_get_api_usage_stats '{}' --json

Shortcut

kosmo integrations:apollo apollo_get_api_usage_stats '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

apollo.apollo_search_people 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_search_people --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_enrich 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_enrich --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_bulk_enrich_people 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_bulk_enrich_people --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_organizations 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_organizations --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_enrich_organization 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_enrich_organization --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_bulk_enrich_organizations 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_bulk_enrich_organizations --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_organization_job_postings 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_organization_job_postings --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_search_contacts 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_search_contacts --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_get_contact 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_get_contact --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_create_contact 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_create_contact --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_update_contact 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_update_contact --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_bulk_create_contacts 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_bulk_create_contacts --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_contact_stages 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_contact_stages --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_search_accounts 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_search_accounts --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_get_organization 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_get_organization --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_create_account 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_create_account --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_update_account 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_update_account --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_bulk_create_accounts 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_bulk_create_accounts --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_account_stages 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_account_stages --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_get_current_user 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_get_current_user --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_users 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_users --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_list_email_accounts 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_list_email_accounts --json

Parameter	Type	Required	Description
No parameters.

apollo.apollo_get_api_usage_stats 0 parameters

Schema command

kosmo integrations:schema apollo.apollo_get_api_usage_stats --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.