Skip to main content

Apollo MCP

Use Apollo tools through the MAD broker with portal grant auth plus per-user Apollo API key BYOK.

Authentication​

  • Header: Authorization

  • Format: Bearer mad_live_***

  • Portal forwards a protected grant header to Apollo MCP.

  • Each user configures their own Apollo API key in MCP Hub.

Catalog Coverage​

  • Raw provider tools: 71
  • Exposed compatibility tools: 71
  • Agent-ready tools: 65
  • Documented descriptors: 71
  • Public reference pages: 71
  • Source repository: https://github.com/MADPANDA3D/APOLLO-MCP
  • Catalog version: 1.0.2
  • Catalog verified: 2026-07-12T20:20:10.707752+00:00 (5 days old)
  • Guide verified: not manually verified (not verified)
  • Committed snapshot: catalog-5ec40de147b11c40
  • Docs generated: 2026-07-18T00:19:58.776Z

Read-only Tools​

  • apollo_experimental_auth_health — apollo_experimental_auth_health (GET /v1/auth/health). Notes: undocumented_but_referenced.
  • apollo_experimental_supported_technologies_csv — apollo_experimental_supported_technologies_csv (GET /v1/auth/supported_technologies_csv). Notes: undocumented_but_referenced.
  • Build an Apollo OAuth authorization URL — Use this local helper to build an Apollo authorization-code URL from client ID, redirect URI, scopes, and caller-generated state. It does not contact Apollo or change state. The result contains the authorization URL; the caller must validate state after callback.
  • Check Apollo MCP configuration — Use this local read-only navigation tool to verify that the Portal gate, request-scoped Apollo credential mode, safety mode, and raw fallback settings are usable. It never contacts Apollo and returns booleans and modes only, never credential values.
  • Check Apollo MCP runtime health — Use this local read-only check to inspect Apollo MCP runtime mode and catalog identity without contacting Apollo or exposing credentials. It confirms the MCP process can execute an authenticated tool call.
  • Check Email Stats — Check Email Stats (GET /emailer_messages/{id}/activities).
  • Find Apollo tools — Use this local read-only navigation tool to rank Apollo tools by punctuation-normalized, multi-token matches across name, aliases, title, description, and category. It never contacts Apollo. Results default to agent-ready tools; set include_legacy only for advanced fallback discovery.
  • Get a List of All Custom Fields — Get a List of All Custom Fields (GET /typed_custom_fields). Notes: master_api_key_required.
  • Get a List of All Lists — Get a List of All Lists (GET /labels). Notes: master_api_key_required.
  • Get a List of Email Accounts — Get a List of Email Accounts (GET /email_accounts). Notes: master_api_key_required.
  • Get a List of Fields — Get a List of Fields (GET /fields). Notes: master_api_key_required.
  • Get a List of Notes — Get a List of Notes (GET /notes).
  • Get a List of Users — Get a List of Users (GET /users/search). Notes: master_api_key_required.
  • Get Complete Organization Info — Get Complete Organization Info (GET /organizations/{id}).
  • Get lossless Apollo tool usage — Use this local read-only navigation tool after discovery to retrieve one complete Apollo descriptor, including every input, output, risk, confirmation, and documentation field. It never contacts Apollo and does not truncate safety or parameter semantics.
  • Get the Apollo OAuth API profile — Use this read-only helper to verify the configured Apollo OAuth token owner. It contacts Apollo but does not change state and returns the token owner's API profile without returning request credentials.
  • Inspect Apollo endpoint coverage — Use this local read-only navigation tool to see which Apollo reference endpoints map to canonical tools, including method, path, documentation link, risk, and experimental status. It never contacts Apollo. Filter by category or include experimental endpoints when needed.
  • List Account Stages — List Account Stages (GET /account_stages). Notes: master_api_key_required.
  • List All Deals — List All Deals (GET /opportunities/search). Notes: master_api_key_required.
  • List Apollo capabilities and descriptors — Use this local read-only navigation tool to retrieve the deterministic, lossless Apollo ToolManifest. Set include_descriptors=true for every ordered descriptor, complete schema, risk annotation, catalog identity, build SHA, and descriptor hash; the compact default returns identity and counts only. It never contacts Apollo.
  • List Contact Stages — List Contact Stages (GET /contact_stages).
  • List Deal Stages — List Deal Stages (GET /opportunity_stages). Notes: master_api_key_required.
  • News Articles Search — News Articles Search (POST /news_articles/search).
  • Organization Enrichment — Organization Enrichment (GET /organizations/enrich). Notes: bulk_limit_10_companies.
  • Organization Job Postings — Organization Job Postings (GET /organizations/{organization_id}/job_postings). Notes: consumes_credits, display_limit_10000.
  • Organization Search — Organization Search (POST /mixed_companies/search). Notes: consumes_credits, display_limit_50000.
  • People API Search — People API Search (POST /mixed_people/api_search). Notes: master_api_key_required, no_credit_consumption, display_limit_50000.
  • Search Apollo organizations — Use this read-only workflow helper to search Apollo organizations with Apollo query parameters. It contacts Apollo but does not intentionally change workspace data and returns compact, normalized organization results with pagination metadata. Requires Portal grant and Apollo credentials.
  • Search Apollo people — Use this read-only workflow helper to search Apollo people with Apollo query parameters. It contacts Apollo but does not intentionally change workspace data and returns compact, normalized people results with pagination metadata. Requires Portal grant and Apollo credentials.
  • Search for Accounts — Search for Accounts (POST /accounts/search). Notes: display_limit_50000.
  • Search for Calls — Search for Calls (GET /phone_calls/search).
  • Search for Contacts — Search for Contacts (POST /contacts/search). Notes: display_limit_50000.
  • Search for Outreach Emails — Search for Outreach Emails (GET /emailer_messages/search).
  • Search for Sequences — Search for Sequences (POST /emailer_campaigns/search). Notes: master_api_key_required.
  • Search for Tasks — Search for Tasks (POST /tasks/search). Notes: master_api_key_required, display_limit_50000.
  • View a Contact — View a Contact (GET /contacts/{contact_id}). Notes: master_api_key_required.
  • View an Account — View an Account (GET /accounts/{id}).
  • View API Usage Stats and Rate Limits — View API Usage Stats and Rate Limits (POST /usage_stats/api_usage_stats).
  • View Deal — View Deal (GET /opportunities/{opportunity_id}). Notes: master_api_key_required.

Write and Destructive Tools​

  • Activate a Sequence — Activate a Sequence (POST /emailer_campaigns/{sequence_id}/approve). Notes: master_api_key_required.
  • Add Contacts to a Sequence — Add Contacts to a Sequence (POST /emailer_campaigns/{sequence_id}/add_contact_ids). Notes: master_api_key_required.
  • apollo_experimental_update_account_stage_bulk — apollo_experimental_update_account_stage_bulk (POST /accounts/update_stages). Notes: docs_page_missing_api_definition.
  • Archive a Sequence — Archive a Sequence (POST /emailer_campaigns/{sequence_id}/archive). Notes: master_api_key_required.
  • Bulk Create Accounts — Bulk Create Accounts (POST /accounts/bulk_create). Notes: bulk_limit_100_accounts.
  • Bulk Create Contacts — Bulk Create Contacts (POST /contacts/bulk_create). Notes: bulk_limit_100_contacts.
  • Bulk Create Tasks — Bulk Create Tasks (POST /tasks/bulk_create). Notes: master_api_key_required.
  • Bulk Organization Enrichment — Bulk Organization Enrichment (POST /organizations/bulk_enrich). Notes: bulk_limit_10_companies.
  • Bulk People Enrichment — Bulk People Enrichment (POST /people/bulk_match). Notes: consumes_credits, bulk_limit_10_people, async_behavior.
  • Bulk Update Accounts — Bulk Update Accounts (POST /accounts/bulk_update). Notes: master_api_key_required, bulk_limit_1000_accounts, async_behavior.
  • Bulk Update Contacts — Bulk Update Contacts (POST /contacts/bulk_update). Notes: bulk_limit_1000_contacts, async_behavior.
  • Bulk-enrich Apollo organizations — Use this workflow helper to bulk-enrich organizations through Apollo. Apollo classifies this POST endpoint as write-intent in the current MCP safety model, so confirm=true is required. Returns normalized enrichment results and safe metadata. Requires Portal grant and Apollo credentials.
  • Bulk-enrich Apollo people — Use this workflow helper to bulk-match people through Apollo. Apollo classifies this POST endpoint as write-intent in the current MCP safety model, so confirm=true is required. Returns normalized enrichment results and safe metadata. Requires Portal grant and Apollo credentials.
  • Call an allowlisted Apollo endpoint — Use this advanced legacy fallback only when no canonical Apollo tool covers an allowlisted API or OAuth endpoint. It contacts Apollo; non-read methods require confirm=true and may change or overwrite data. The URL host/path and body/response sizes are enforced by server allowlists.
  • Create a Contact — Create a Contact (POST /contacts).
  • Create a Custom Field — Create a Custom Field (POST /fields).
  • Create a Task — Create a Task (POST /tasks). Notes: master_api_key_required.
  • Create an Account — Create an Account (POST /accounts). Notes: master_api_key_required.
  • Create Call Records — Create Call Records (POST /phone_calls).
  • Create Deal — Create Deal (POST /opportunities). Notes: master_api_key_required.
  • Deactivate a Sequence — Deactivate a Sequence (POST /emailer_campaigns/{sequence_id}/abort). Notes: master_api_key_required.
  • Exchange an Apollo OAuth authorization code — Use this legacy credential helper to exchange a short-lived Apollo authorization code. It contacts Apollo and may return sensitive OAuth tokens, so callers must never log or persist the result outside an approved credential store. It does not change Apollo workspace records.
  • People Enrichment — People Enrichment (POST /people/match). Notes: consumes_credits, bulk_limit_10_people, async_behavior.
  • Refresh an Apollo OAuth access token — Use this legacy credential helper to refresh Apollo OAuth credentials. It contacts Apollo and may return sensitive tokens, so callers must never log or persist the result outside an approved credential store. Repeating the call may rotate credentials and is not treated as idempotent.
  • Update a Contact — Update a Contact (PATCH /contacts/{contact_id}).
  • Update Account Owner for Multiple Accounts — Update Account Owner for Multiple Accounts (POST /accounts/update_owners). Notes: master_api_key_required.
  • Update an Account — Update an Account (PATCH /accounts/{account_id}). Notes: master_api_key_required.
  • Update Call Records — Update Call Records (PUT /phone_calls/{id}).
  • Update Contact Owner for Multiple Contacts — Update Contact Owner for Multiple Contacts (POST /contacts/update_owners).
  • Update Contact Stage for Multiple Contacts — Update Contact Stage for Multiple Contacts (POST /contacts/update_stages).
  • Update Contact Status in a Sequence — Update Contact Status in a Sequence (POST /emailer_campaigns/remove_or_stop_contact_ids). Notes: master_api_key_required.
  • Update Deal — Update Deal (PATCH /opportunities/{opportunity_id}). Notes: master_api_key_required.