FastMCP server for Apollo

Search organizations.

Search Apollo people database. Does NOT burn credits (search is free; reveal costs). Uses /mixed_people/api_search (Apollo deprecated /mixed_people/search for API callers in 2026 with HTTP 422). Verified 2026-05-11.

Enrich a single person. BURNS 1 credit if reveal_personal_emails=True.

Enroll contacts into a sequence. contact_ids are Apollo contact IDs.

Create a new email sequence (emailer_campaign). Starts PAUSED by default. Use apollo_step_create to add steps. Use apollo_sequence_set_active(True) to launch when ready. Args: name: Sequence name shown in Apollo UI. label: Optional cross-reference label (echoed in response only). permissions: "team_can_use" | "private" | "team_can_view_and_edit". active: Start active. Default False so steps can be built first.

Detailed sequence info including steps and stats.

Remove contacts from a sequence. Apollo has no working sequence-scoped unenroll endpoint: - POST /emailer_campaigns/{id}/remove_contact_ids -> 404 - POST /emailer_campaigns/remove_contact_ids -> 200 but no-op The only reliable way to stop future sends is to delete the contact with DELETE /contacts/{id}, which cascades and removes all campaign enrollments. Destructive: the contact record itself is marked deleted. Verified 2026-04-17.

Activate or pause a sequence (active=True to activate, False to pause). Uses PATCH + flat body, matching the working pattern in apollo_template_update and apollo_mailbox_update_cap. The prior PUT + nested-wrap pattern silently no-op'd in production — the same antipattern that apollo_template_update's own comments document for /emailer_templates. Post-write verify: re-fetches the campaign after the PATCH and compares the active flag. Surfaces a _warning if Apollo accepted the request but didn't apply the change (which may indicate a separate UI-only activation constraint for cold-outreach cam…

List all email sequences with label + active state + top-level stats. Uses POST /emailer_campaigns/search (GET /emailer_campaigns creates an empty sequence — a dangerous Apollo API quirk).

Create a sequence step plus its initial touch and template in one call. Args: sequence_id: The emailer_campaign ID. position: 1-based position in the sequence. wait_days: Days to wait BEFORE this step fires (position 1 typically 0). subject: Email subject line. body_text: Plain-text body. body_html: Optional HTML body. Auto-generated from body_text if None. step_type: "auto_email" (default) or "manual_email". include_signature: Append the user's saved signature.

Create a task in Apollo. priority=low|medium|high. type=call|action_item|linkedin|outreach_manual_email.

Get an emailer template by ID. Use to audit current state before update. Args: template_id: The emailer_template ID (NOT the step or touch ID).

Update an emailer template subject and/or body. Destructive write. Snapshots the current template to APOLLO_AUDIT_LOG_PATH (if set) BEFORE the update, so any breakage is reversible from the audit log diff. Args: template_id: The emailer_template ID. subject: New subject line. Leave None to keep current. body_text: New plain-text body. Leave None to keep current. body_html: New HTML body. Auto-generated from body_text if None and body_text is provided. audit_label: Optional human label for the audit log entry.