apollo-io-mcp-server

kingler/apollo-io-mcp-server

3.2

If you are the rightful owner of apollo-io-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Apollo.io MCP Server is designed to facilitate lead management and marketing automation by leveraging Apollo.io's API.

Tools
5
Resources
0
Prompts
0

Apollo.io MCP Server

MCP server for Apollo.io

Features

  • Lead Search: Search for prospects based on job title, industry, company size, and location
  • Contact Enrichment: Enrich contact information with additional data from Apollo.io
  • Email Sequences: Create and manage automated email sequences for lead nurturing
  • Account Data: Retrieve account-based marketing data for companies
  • Engagement Tracking: Track email and call engagement metrics for campaigns

Installation

npm install

Configuration

  1. Copy .env.example to .env:
cp .env.example .env
  1. Add your Apollo.io API key to .env:
APOLLO_API_KEY=your_actual_api_key_here

Usage

Development

npm run dev

Production

npm run build
npm start

Custom Port

npm start -- --port=8080

Testing

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Watch mode for development
npm run test:watch

Available MCP Tools

search-leads

Search for prospects based on various criteria.

Parameters:

  • jobTitle: Job title to search for (e.g., CEO, CFO, CTO)
  • industry: Industry sector (e.g., Aviation, Technology, Finance)
  • companySize: Company size range (e.g., 50-200, 200-500, 500+)
  • location: Geographic location (country, state, or city)
  • limit: Maximum number of results (default: 25)

enrich-contact

Enrich contact information with additional data.

Parameters:

  • email: Email address of the contact (required)
  • linkedinUrl: LinkedIn profile URL (optional)

create-email-sequence

Create an automated email sequence for lead nurturing.

Parameters:

  • name: Name of the email sequence (required)
  • contacts: List of contact emails (required)
  • templateIds: List of email template IDs
  • delayDays: Days to wait between each email

get-account-data

Retrieve account-based marketing data for a company.

Parameters:

  • domain: Company domain (required)
  • includeContacts: Include contact information (default: true)

track-engagement

Track email and call engagement metrics.

Parameters:

  • sequenceId: ID of the sequence to track (required)
  • startDate: Start date for metrics (YYYY-MM-DD)
  • endDate: End date for metrics (YYYY-MM-DD)

API Rate Limits

The server implements rate limiting to comply with Apollo.io API restrictions:

  • Maximum 60 requests per minute per tool
  • Automatic exponential backoff on rate limit errors
  • Concurrent request limiting (max 10 simultaneous requests)

Architecture

The server follows MCP (Model Context Protocol) standards with:

  • HTTP Streaming Transport for real-time communication
  • Session management for multiple concurrent connections
  • Structured error handling and logging
  • TypeScript for type safety

License

ISC