](https://www.npmjs.com/package/@agentx-ai/apollo-io-mcp-server)
Apollo.io MCP服务器
功能强大的模型上下文协议（MCP）服务器实现，实现Apollo.io API无缝集成，使人工智能助手能够与Apollo.io数据交互，以丰富人员和组织。
特性
- 人员充实：用全面的信息丰富联系人数据
- 组织充实：获取详细的公司信息和见解
- 人员搜索：根据各种标准查找人员
- 组织搜索：发现符合特定标准的公司
- 工作海报：访问特定组织的招聘信息
- 电子邮件发现：使用Apollo.io个人ID获取电子邮件地址
- 公司员工：查找特定公司的员工
安装
npm install @agentx-ai/apollo-io-mcp-server运行服务器
选项1:HTTP服务器（建议用于自托管）
在支持动态API密钥的本地端口上将MCP服务器作为HTTP服务器运行：
# Install dependencies first
npm install
# Optional: Set server authorization token (recommended for production)
export SERVER_AUTH_TOKEN=your_server_auth_token_here
# Run the HTTP server (default port: 3000)
npm run start:http
# Or run with custom port
PORT=8080 npm run start:http
# For development with auto-reload
npm run dev:http服务器将于启动 http://localhost:3000 （或您指定的端口）具有以下端点：
MCP协议端点（SSE）：
- SSE端点:
GET http://localhost:3000/mcp-建立SSE流 - 消息端点:
POST http://localhost:3000/messages?sessionId=-接收客户端JSON-RPC请求
REST API端点（用于n8n和HTTP客户端）：
- 人员充实:
POST /api/v1/people/enrichment - 组织充实:
GET /api/v1/organizations/enrichment?domain= - 人员搜索:
POST /api/v1/people/search - 组织搜索:
POST /api/v1/organizations/search - 组织职位发布:
GET /api/v1/organizations/:organizationId/jobs - 获取个人电子邮件:
GET /api/v1/people/:apolloId/email - 公司员工:
POST /api/v1/companies/employees
公用设施端点：
- 健康检查:
GET /health-服务器运行状况 - API 文档:
GET /api-API端点文档
认证
服务器支持 动态Apollo.io API密钥 每个客户端发送：
所需标题（选择一个）：
X-Apollo-Api-Key:X-Api-Key:Authorization: Bearer
可选服务器授权 （如果 SERVER_AUTH_TOKEN 已设置）：
Authorization: Bearer或X-Server-Token:
n8n使用示例
# People Enrichment
curl -X POST http://localhost:3000/api/v1/people/enrichment \
-H "X-Apollo-Api-Key: your_apollo_api_key" \
-H "Content-Type: application/json" \
-d '{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com"
}'
# Organization Enrichment
curl -X GET "http://localhost:3000/api/v1/organizations/enrichment?domain=apollo.io" \
-H "X-Apollo-Api-Key: your_apollo_api_key"
# People Search
curl -X POST http://localhost:3000/api/v1/people/search \
-H "X-Apollo-Api-Key: your_apollo_api_key" \
-H "Content-Type: application/json" \
-d '{
"person_titles": ["Marketing Manager"],
"q_organization_domains_list": ["apollo.io"]
}'选项2：Stdio服务器（用于MCP检查器）
使用stdio传输运行，以便使用MCP Inspector进行测试：
npm install -g .
npx @modelcontextprotocol/inspector apollo-io-mcp-server然后添加 APOLLO_IO_API_KEY 在环境变量中
可用工具
1.丰富人才(people_enrichment)
用全面的信息丰富联系人数据。
参数：
first_name（string）：人的名字last_name（string）：人的姓氏email（string）：个人的电子邮件地址domain（string）：公司域名organization_name（string）：组织名称linkedin_url（string）：个人的LinkedIn个人资料URL
2.组织充实(organization_enrichment)
获取详细的公司信息和见解。
参数：
domain（string，必填）：您要丰富的公司的域名。不要包含www.、@符号或类似符号（例如“apollo.io”或“microsoft.com”）
3.人员搜索(people_search)
使用全面的筛选选项根据各种标准查找人员。
参数：
person_titles（数组）：你想找的人拥有的职位（例如，“销售开发代表”、“营销经理”、“研究分析师”）include_similar_titles（boolean）：是否包括具有相似职称的人员（默认值：true）q_keywords（string）：用于过滤结果的字符串person_locations（array）：人们居住的地点（例如，“加利福尼亚”、“爱尔兰”、“芝加哥”）person_seniorities（数组）：工作资历级别（例如，“所有者”、“创始人”、“c_suite”、“合伙人”、“副总裁”、“主管”、“董事”、“经理”、“高级”、“入职”、“实习生”）organization_locations（array）：一个人当前雇主的公司总部所在地（例如，“德克萨斯州”、“东京”、“西班牙”）q_organization_domains_list（array）：该人雇主的域名（例如“apollo.io”、“microsoft.com”）contact_email_status（数组）：要筛选的电子邮件状态（例如，“已验证”、“未验证”、”可能参与“、”不可用“）organization_ids（数组）：要包含在搜索结果中的特定公司（雇主）的Apollo IDorganization_num_employees_ranges（数组）：该人当前公司的员工计数范围（例如，“1,10”、“250500”、“1000020000”）revenue_range（object）：该人当前雇主的收入范围
- min （整数）：该人当前雇主产生的最低收入（无货币符号、逗号或小数） - max （整数）：该人当前雇主产生的最大收入（无货币符号、逗号或小数）
currently_using_all_of_technology_uids（数组）：根据当前雇主使用的所有技术查找人员（空格用下划线表示，例如“salesforce”、“google_analytics”、“wordpress_org”）currently_using_any_of_technology_uids（数组）：根据当前雇主使用的任何技术查找人员（空格用下划线表示，例如“salesforce”、“google_analytics”、“wordpress_org”）currently_not_using_any_of_technology_uids（数组）：根据当前雇主使用的技术排除人员（空格用下划线表示，例如“salesforce”、“google_analytics”、“wordpress_org”）q_organization_job_titles（数组）：该人当前雇主的活跃招聘信息中列出的职位（例如，“销售经理”、“研究分析师”）organization_job_locations（array）：该人的雇主正在积极招聘的工作地点（例如“亚特兰大”、“日本”）organization_num_jobs_range（object）：该人当前雇主活跃的职位发布数量范围
- min （整数）：该人当前雇主的最低活跃职位发布数量 - max （整数）：该人当前雇主的最大活跃职位发布数
organization_job_posted_at_range（object）：该人当前雇主发布工作的日期范围
- min （string）：该人当前雇主发布工作的最早日期（YYYY-MM-DD） - max （string）：该人当前雇主发布工作的最新日期（YYYY-MM-DD）
page（整数）：分页页码（默认值：1）per_page（整数）：每页结果数（最大值：100，默认值：25）
4.组织搜索(organization_search)
通过全面的筛选选项发现符合特定条件的公司。
参数：
q_organization_domains_list（array）：要搜索的组织域列表organization_locations（array）：公司总部的位置（例如，“德克萨斯州”、“东京”、“西班牙”）organization_not_locations（数组）：根据位置从搜索结果中排除公司（例如，“明尼苏达州”、“爱尔兰”、“首尔”）organization_num_employees_ranges（数组）：员工计数范围，用逗号分隔上下数字（例如“1,10”、“250500”、“1000020000”）revenue_range（object）：根据收入范围搜索组织
- min （整数）：最低收入金额（无货币符号、逗号或小数） - max （整数）：最大收入金额（无货币符号、逗号或小数）
currently_using_any_of_technology_uids（数组）：该组织目前使用的技术（使用下划线表示空格，例如“salesforce”、“google_analytics”、“wordpress_org”）q_organization_keyword_tags（数组）：根据与公司相关的关键字（例如“采矿”、“销售策略”、“咨询”）过滤搜索结果q_organization_name（string）：筛选搜索结果以包含特定公司名称（接受部分匹配）organization_ids（数组）：要包含在搜索结果中的特定公司的Apollo IDlatest_funding_amount_range（对象）：公司最近一轮融资的融资金额范围
- min （整数）：最近一轮融资的最低金额（无货币符号、逗号或小数） - max （整数）：最近一轮融资的最大金额（无货币符号、逗号或小数）
total_funding_range（对象）：所有融资轮的总融资金额范围
- min （整数）：所有轮次的最低总资金金额（无货币符号、逗号或小数） - max （整数）：所有轮次的最大总资金金额（无货币符号、逗号或小数）
latest_funding_date_range（对象）：公司收到最近一轮融资的日期范围
- min （string）：最近一轮融资的最早日期（YYYY-MM-DD） - max （string）：最近一轮融资的最新日期（YYYY-MM-DD）
q_organization_job_titles（数组）：公司活跃招聘信息中列出的职位（例如“销售经理”、“研究分析师”）organization_job_locations（array）：公司正在积极招聘的工作地点（例如“亚特兰大”、“日本”）organization_num_jobs_range（object）：公司当前发布的职位数量范围
- min （整数）：公司中活跃的职位发布的最小数量 - max （整数）：公司当前发布的职位的最大数量
organization_job_posted_at_range（object）：公司发布职位的日期范围
- min （string）：公司发布工作的最早日期（YYYY-MM-DD） - max （string）：公司发布职位的最新日期（YYYY-MM-DD）
page（整数）：分页页码（默认值：1）per_page（整数）：每页结果数（最大值：100，默认值：25）
5.组织职位发布(organization_job_postings)
访问特定组织的招聘信息。
参数：
organization_id（字符串，必填）：Apollo.io组织ID
6.获取个人电子邮件(get_person_email)
获取使用阿波罗ID的人的电子邮件地址。
参数：
apollo_id（字符串，必填）：Apollo.io个人ID
7.公司员工(employees_of_company)
使用公司名称或网站/Linkin URL查找公司员工。
参数：
company（字符串，必填）：公司名称website_url（string）：公司网站URLlinkedin_url（string）：公司领英URL
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。