Skip to content

Add Explorium company list creation tool#13

Merged
Jeanne-Li merged 1 commit into
mainfrom
claude/amazing-mendel-nizz3e
Jun 10, 2026
Merged

Add Explorium company list creation tool#13
Jeanne-Li merged 1 commit into
mainfrom
claude/amazing-mendel-nizz3e

Conversation

@Jeanne-Li

Copy link
Copy Markdown
Contributor

Summary

Add support for creating Explorium-backed organization lists via a new MCP tool explorium_create_company_list. This complements the existing people list creation tool and allows users to search for and enrich company data.

Key Changes

  • New API endpoint wrapper: POST /api/v1/explorium/companies/create-list in repository layer
  • New MCP tool: explorium_create_company_list with schema validation for company search criteria (country_code, company_size, company_revenue, company_tech_stack_category, etc.)
  • Auto-generated idempotency keys: Tool automatically generates idempotency_key if not provided, ensuring safe retries
  • Documentation updates:
    • Added endpoint to .llm.txt with full parameter documentation
    • Updated ENDPOINT_CHECKLIST.md to reflect new tool and clarify that add-more is people-only
    • Updated TOOL_REFERENCE.md and README.md to reflect 64 total tools (was 63)
    • Updated testing checklist to include new company list flow
  • Tool count: Incremented from 63 to 64 tools across all documentation and verification scripts

Implementation Details

  • Follows existing pattern from explorium_create_list for consistency
  • Returns async ProspectList with search_type: "organizations" and status: "pending"
  • Supports polling via GET /prospect-lists/{id} for progress tracking
  • Explicitly notes that add-more is not supported for organization lists (people-only feature)
  • Cron processes both people and company lists every 5 minutes

https://claude.ai/code/session_01MnMnZHjFtgjrRKhhAaRhHu

max-agent added POST /api/v1/explorium/companies/create-list to build an
organization list (search_type=organizations) from an Explorium company
search. Expose it as a new MCP tool mirroring explorium_create_list:

- repository: exploriumCreateCompanyList -> companies/create-list
- schema: exploriumCreateCompanyListSchema (company/business filter keys)
- tools: register explorium_create_company_list (auto idempotency_key)
- verify-tools + audit-endpoints: include the new tool
- docs: TOOL_REFERENCE, ENDPOINT_CHECKLIST, .llm.txt, tool counts

https://claude.ai/code/session_01MnMnZHjFtgjrRKhhAaRhHu
@vercel

vercel Bot commented Jun 10, 2026

Copy link
Copy Markdown

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

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

Request Review

@Jeanne-Li Jeanne-Li merged commit 632c5d0 into main Jun 10, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants