get_converted_leads_summary
Fast aggregate summary of the account's converted leads (Smart Leads) — counts and rates only, no lead rows.
Read analytics
Returns data. Calling it changes nothing, so it is safe in an unattended loop.
What it does
Fast aggregate summary of the account's converted leads (Smart Leads) — counts and rates only, no lead rows. ALSO KNOWN AS: leads summary, lead totals, lead overview, MQL rate, lead-to-MQL conversion, smart leads summary. KEYWORDS: LEAD COUNT, LEAD TOTALS, HOW MANY LEADS, LEADS SUMMARY, LEAD OVERVIEW, SMART LEADS, CONVERTED LEADS, MQL RATE, LEAD-TO-MQL, MQLS, UNIQUE LEADS, UNIQUE DOMAINS, LEAD CHANNEL MIX, LEADS BY CHANNEL, ENRICHMENT COVERAGE, SYNCED TO MARKETING AUTOMATION, LEAD QUALITY BASELINE, LEAD AUDIT BASELINE, PIPELINE FROM LEADS, TRIGGERED OPPORTUNITIES, INFLUENCED OPPORTUNITIES, LEAD SANITY CHECK USE FOR: "How many leads do we have?", MQL rate and lead-to-MQL sanity checks, channel mix of leads (Facebook/Instagram/LinkedIn/Google Ads/display), enrichment coverage, leads synced to marketing automation, unique leads vs unique company domains, pipeline tie-back (triggered/influenced opportunities and amounts). ALWAYS call this FIRST in a lead audit to set the baseline before pulling rows with get_converted_leads. NOT FOR: Inspecting individual leads or job-title/ICP distributions (use get_converted_leads); campaign performance metrics (use experiment_performance_stats). RETURNED DATA: total | totalFacebook, totalInstagram, totalLinkedin, totalGoogleAds | fullyEnriched, autoEnriched, unenriched | syncedToMa | uniqueLeads, uniqueDomain | mqls, uniqueMqls, mqlRate, uniqueMqlRate | influencedOpps, triggeredOpps, influencedAmount, triggeredAmount. RULES: - Accepts the same filters as get_converted_leads (no pagination/sort) — scope by campaignName/channels/startDate+endDate to summarize a slice. - mqlRate is a useful lead-quality indicator, but clients define MQL criteria differently and it rarely matches a true MQL — treat it as a secondary signal next to job-title/ICP fit. - uniqueDomain vs total shows lead concentration: many leads from few domains can mean a few companies dominate the results.
Arguments
| Argument | Type | Notes | |
|---|---|---|---|
statuses |
array | Lead statuses to include. The platform Leads tab defaults to ACTIVE. Omit to include all. | |
campaignName |
string | Filter by campaign name (partial match). | |
experimentName |
string | Filter by experiment name (partial match). | |
customAudienceName |
string | Filter by targeted audience name (partial match). | |
adName |
string | Filter by the ad (library) name that captured the leads (partial match). | |
offerName |
string | Filter by the offer name tied to the leads' experiments. | |
jobTitle |
string | Filter by lead job title (partial match). | |
email |
string | Filter by lead email (partial match). | |
firstName |
string | Filter by lead first name (partial match). | |
lastName |
string | Filter by lead last name (partial match). | |
businessEmails |
array | Filter by exact business email addresses (OR within the list). | |
modifiedBy |
string | Filter by the platform user email who last modified the leads (partial match). | |
companies |
array | Filter by exact company names. | |
countries |
array | Filter by exact lead country names. | |
channels |
array | Filter by acquisition channel(s). | |
audienceTypes |
array | Filter by audience type of the leads' experiments (e.g. FIRMOGRAPHIC_INCLUDE, CONTACT_LIST, BUYER_INTENT, NATIVE_LINKEDIN). | |
contentTypes |
array | Data-completeness filter: only leads that HAVE this content. | |
qualityTypes |
array | Quality-signal filter (opportunities, MQL date/score). | |
keyword |
string | Filter by the exact search keyword that captured the leads. | |
matchTypes |
array | Filter by keyword match type (search channels). | |
startDate |
string | Leads created on/after this date. ISO 8601; date-only is accepted. | |
endDate |
string | Leads created on/before this date. ISO 8601; date-only is accepted. | |
isFullyEnriched |
boolean | true = only fully enriched leads; false = only not fully enriched. | |
isAutoUpdated |
boolean | true = only auto-enriched leads. | |
isManuallyUpdate |
boolean | true = only manually enriched/edited leads (platform parameter name is 'isManuallyUpdate'). | |
syncMA |
boolean | true = only leads synced to marketing automation; false = only unsynced. | |
ids |
array | Restrict the summary to specific lead IDs. | |
tagIds |
array | Filter by tag IDs on the leads' experiments. |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_converted_leads_summary","arguments":{}}}'Response
Real, from the production server, in 334 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.
recorded response
"[value redacted]"Related
Other analytics tools: