Reference

MCP server

LeadMCP runs a remote MCP server over streamable HTTP. Connect an MCP client once, then ask it to search, enrich and export. The tools cover the REST API plus the products that have no REST route.

Server URL

https://leadmcp.ai/api/mcp

Client setup

Create an API key in the app under Integrations.
Add the server URL to your MCP client configuration.
Send the key in the X-API-Key header, or as an Authorization: Bearer header.
Restart the client and confirm the tools appear.

This release uses API key authentication. Sign-in connections are planned.

Health

Tool	REST endpoint	Description
`leadmcp_health`	GET`/api/health`	Ping the LeadMCP origin. No API key for the REST health endpoint. Returns ok, service and version when reachable.

Usage

Tool	REST endpoint	Description
`get_fair_use`	GET`/api/v1/usage/fair-use`	Remaining unlimited-plan daily/monthly fair-use budget for search/export/enrich (0 credits). Includes used, remaining, caps, and UTC resets_at. Daily resets at next 00:00 UTC, not 24 hours after hitting the cap.

Enrichment

Tool	REST endpoint	Description
`leadmcp_get_emails_from_linkedin_batch`	POST`/api/v1/enrich/from-linkedin`	Find work emails and contact details from professional profile URLs. Accepts up to 100 people per batch; charges one credit per successful match.
`leadmcp_get_linkedin_urls_from_emails_batch`	POST`/api/v1/enrich/from-email`	Find professional profile profiles and contact details from work email addresses. Accepts up to 100 people per batch; charges one credit per successful match.
`leadmcp_enrich_person_batch`	POST`/api/v1/enrich/from-person`	Enrich people from first name, last name, and company name or domain. Accepts up to 100 people per batch; charges one credit per successful match.
`create_csv_enrichment_upload_link`	MCP only	Create a browser upload link for CSV enrichment. Upload a CSV up to 15 MB or supply a public Google Sheet, then map columns and start the run.
`check_enrichment_upload`	MCP only	Check whether an enrichment upload has been submitted and retrieve its run_id so the client can follow the run.
`check_enrichment_status`	MCP only	Check an enrichment run for its current status, processed rows and results. Use the run_id returned after upload.
`get_enrichment_result`	MCP only	Retrieve the completed enrichment result as a signed CSV download link. The download link expires after one hour.

Contacts

Tool	REST endpoint	Description
`leadmcp_contacts_health`	GET`/api/v1/contacts/health`	Check contact database connectivity and the approximate number of available contact records. This diagnostic does not spend credits.
`leadmcp_lookup_contact_by_phone`	GET`/api/v1/contacts/lookup/phone`	Look up a contact by phone number and return the matching contact details. Charges one credit when a match is found.
`leadmcp_lookup_contacts_by_phone_batch`	POST`/api/v1/contacts/from-phone`	Look up contacts from a batch of phone numbers. Each successful match costs one credit; unsuccessful matches do not spend credits.
`leadmcp_lookup_colleagues`	POST`/api/v1/contacts/lookup/colleagues`	Find colleagues at a company from a work email or company domain. Returns 100 contacts per page by default, up to 5,000 through REST, at one credit per returned contact.
`lookup_decision_makers`	POST`/api/v1/contacts/lookup/decision-makers`	Find decision makers with valid emails at a company: executives, VPs, directors and head-of roles. Returns up to 100 contacts per MCP call at one credit per contact.

Search

Tool	REST endpoint	Description
`count_contacts`	POST`/api/v1/contacts/search/count`	Count all contacts matching a filter set without returning records or spending credits. Use the exact count to size an audience before searching or exporting.
`search_contacts`	POST`/api/v1/contacts/search`	Search contacts with the same filters as REST. Returns up to 100 rows per MCP call, pagination fields including next_offset, and an export_offer when has_more is true. Charges one credit per row.
`export_contacts`	POST`/api/v1/contacts/search/export`	Start an asynchronous CSV export of matching contacts. Returns export_id immediately; exports up to 50,000 rows, subject to available credits and fair-use limits. Charges one credit per exported row.
`check_contact_export`	GET`/api/v1/contacts/search/export/{export_id}`	Check the status of a contact export using its export_id. Completed exports include the row count and a signed CSV download URL valid for 24 hours.
`get_available_values`	GET`/api/v1/contacts/filter-values`	Get the allowed values for a named list filter, such as country, seniority or email status. Free-text filters do not have fixed value lists. This lookup is free.
`get_available_columns`	MCP only	List available contact columns, labels, types, supported filters and export options, including populated_count and fill_share to help assess field coverage.