Add Explorium as alternative data supplier for prospect lists

[Jeanne-Li]

Summary

Adds Explorium as an alternative data supplier to Apollo for prospect list creation and enrichment. This includes new MCP tools, API endpoints, schema validation, and comprehensive documentation updates.

Key Changes

New Features

• Explorium MCP Tools (2 new tools):
  • explorium_create_list: Create Explorium-backed prospect lists with async processing
  • explorium_add_more: Append additional leads to existing Explorium lists
  • Both tools auto-inject idempotency_key for safe retries

Implementation

• Schema validation (features/pilot-tools/explorium/schema.ts):

  • exploriumCreateListSchema: Validates list name, search criteria, and optional idempotency key
  • exploriumAddMoreSchema: Validates list ID and optional lead count (1-10000)

• Repository layer (features/pilot-tools/explorium/repository.ts):

  • exploriumCreateList(): POST to /api/v1/explorium/people/create-list
  • exploriumAddMore(): POST to /api/v1/explorium/people/add-more

• Tool registration (features/pilot-tools/explorium/tools.ts):

  • Registers both tools with MCP server
  • Handles token extraction and API calls via shared utilities

Documentation Updates

• API Reference (public/.llm.txt):

  • Added Explorium to scope table with prospect-lists:write requirement
  • Updated prospect list creation docs to mention Explorium endpoint
  • Added search_source values to include explorium
  • New EXPLORIUM section with full endpoint documentation and examples

• Tool Reference (docs/TOOL_REFERENCE.md):

  • Updated tool count from 63 to 65
  • Added Explorium section (2 tools) with HTTP endpoints and scope requirements
  • Clarified Apollo and Explorium as interchangeable suppliers

• Testing & Verification:

  • Updated ENDPOINT_CHECKLIST.md with Explorium endpoints and status
  • Added Explorium to TESTING.md billing warnings
  • Updated verify-tools.mjs to expect 2 new Explorium tools
  • Updated audit-endpoints.mjs to skip Explorium tools for billing reasons

• Project Structure (docs/README.md):

  • Added explorium/ to feature directory listing

Integration

• Registered Explorium tools in main MCP registration (features/pilot-tools/mcp/register.ts)
• Follows same async pattern as Apollo with status polling via wait_for_prospect_list
• Supports same search criteria model (job_level, job_department, company_size, etc.)

Notable Details

• Both Explorium endpoints are async with status progression: pending → processing → completed (or failed after 3 retries)
• Idempotency keys are auto-generated if not provided, enabling safe retries
• Explorium and Apollo are interchangeable suppliers; workspace chooses based on available API key
• Tools marked as "not tested" in checklist due to credit charges (same as Apollo)

https://claude.ai/code/session_01JJA4vx6BW3rEaQxgcNsj5m

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
max-mcp-server	Ready	Preview, Comment	Jun 9, 2026 3:10pm