Deeplead
Find local businesses, companies and decision makers with verified emails for B2B outreach.
Should I use this
Quality & Safety
A
Findings (2)
- LOWTool 'credits_get' description lacks action verbin credits_get
- LOWTool 'organizations_find_decision_maker' name length outside 3-30 rangein organizations_find_decision_maker
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,216Tokens (tool definitions)
~6.9 KBTypical response size
Significant attention impact (5.64% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"deeplead": {
"url": "https://www.deeplead.io/api/mcp"
}
}
}Remote endpoints
https://www.deeplead.io/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟡businesses_search(niches, location, page, radiusMiles, keyword, ...)
Search local businesses from Google Business Profiles. 23M+ businesses with ratings, reviews, website contacts, socials and ad pixels. 30 per page. Charges 1 credit per business with an email or phone and 0.5 per business without. saveToContacts also stores them in your contacts. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"niches": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Google categories or plain niches, e.g. [\"dentist\"]"
},
"location": {
"type": "string",
"minLength": 1,
"description": "A city (\"Austin, TX\"), a US state (\"Texas\") or a country (\"Germany\")"
},
"page": {
"default": 1,
"description": "Page number, starting at 1; up to 30 businesses per page",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"radiusMiles": {
"description": "Around a city; default 30",
"type": "number",
"minimum": 1,
"maximum": 100
},
"keyword": {
"description": "Matched against the business name and categories",
"type": "string"
},
"excludedNiches": {
"description": "Business categories or niches to exclude",
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"description": "Google rating band to match",
"type": "string",
"enum": [
"under-4",
"4-to-4.5",
"4.5-plus"
]
},
"reviews": {
"description": "Google review-count band to match",
"type": "string",
"enum": [
"under-10",
"10-to-100",
"100-plus"
]
},
"require": {
"description": "e.g. { \"email\": true, \"metaAds\": false }; false matches only businesses checked and found without it",
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"metaAds",
"googleAds",
"chatgptAds",
"gAnalytics",
"tiktokPixel",
"claimed",
"website",
"email",
"phone"
]
},
"additionalProperties": {
"type": "boolean"
}
},
"saveToContacts": {
"default": false,
"description": "Save returned businesses to your Deeplead contacts",
"type": "boolean"
}
},
"required": [
"niches",
"location"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"chargedCredits": {
"type": "number"
},
"businesses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"businessId": {
"type": "string"
},
"name": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"rating": {
"type": [
"number",
"null"
]
},
"reviewCount": {
"type": [
"number",
"null"
]
},
"reviewsByStars": {
"type": "array",
"items": {
"type": [
"number",
"null"
]
},
"description": "Counts of 1 to 5 star reviews"
},
"googleProfileClaimed": {
"type": [
"boolean",
"null"
]
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"tiktok"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false
}
},
"required": [
"businessId",
"name",
"categories",
"address",
"city",
"country",
"website",
"email",
"emails",
"phone",
"phones",
"rating",
"reviewCount",
"reviewsByStars",
"googleProfileClaimed",
"socials",
"adPixels"
],
"additionalProperties": false
}
}
},
"required": [
"chargedCredits",
"businesses"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_search(query, semantic, domains, hqCountry, hqState, ...)
Search organizations, or look them up by domain. Charges 0.5 credits per returned organization. limit 0 returns only totalCount, free. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text matched against company name, description and keywords",
"type": "string",
"minLength": 1
},
"semantic": {
"description": "What the company is and sells, matched by meaning, e.g. \"outsourced medical billing for clinics\"",
"type": "string",
"minLength": 1
},
"domains": {
"description": "Look companies up by domain, e.g. [\"stripe.com\"]",
"maxItems": 100,
"type": "array",
"items": {
"type": "string"
}
},
"hqCountry": {
"description": "ISO alpha-2 country codes of the headquarters, e.g. [\"US\", \"DE\"]",
"type": "array",
"items": {
"type": "string"
}
},
"hqState": {
"description": "US state names or codes of the headquarters",
"type": "array",
"items": {
"type": "string"
}
},
"employeeBands": {
"description": "Headcount bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1,000",
"1,001-5,000",
"5,001-10,000",
"10,001+"
]
}
},
"revenueRange": {
"description": "Annual company revenue bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"<$1M",
"$1M to <$10M",
"$10M to <$50M",
"$50M to <$100M",
"$100M to <$1B",
"$1B+"
]
}
},
"industryNaicsDirect": {
"description": "NAICS codes",
"type": "array",
"items": {
"type": "string"
}
},
"technologies": {
"description": "Technologies used by the company",
"type": "array",
"items": {
"type": "string"
}
},
"foundedAfter": {
"description": "Earliest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"foundedBefore": {
"description": "Latest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monthlyVisitsMin": {
"description": "Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"employeeGrowthMin": {
"description": "Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fundedAfter": {
"description": "Year of the last funding round, at least; known for about 1 in 100 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"hqCity": {
"description": "City names of the headquarters, e.g. [\"Austin\"]",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"default": 25,
"description": "Maximum companies to return; 0 returns only a free count",
"type": "integer",
"minimum": 0,
"maximum": 25
},
"offset": {
"default": 0,
"description": "Number of matching companies to skip for pagination",
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"includeWithoutWebsite": {
"default": false,
"description": "Include companies without websites in search results",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"totalCount": {
"type": "number"
},
"chargedCredits": {
"type": "number"
},
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"organizationId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"websiteAlive": {
"type": [
"boolean",
"null"
]
},
"websiteTitle": {
"type": [
"string",
"null"
]
},
"websiteDescription": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"linkedinDescription": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"keywords": {
"type": [
"string",
"null"
]
},
"technologies": {
"type": [
"string",
"null"
]
},
"employeeCount": {
"type": [
"number",
"null"
]
},
"employeeMin": {
"type": [
"number",
"null"
]
},
"employeeMax": {
"type": [
"number",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"monthlyVisits": {
"description": "Estimated monthly website visits",
"type": [
"number",
"null"
]
},
"monthlyGoogleAdSpend": {
"description": "Estimated monthly Google Ads spend in USD",
"type": [
"number",
"null"
]
},
"employeeGrowthRate": {
"description": "Employee growth on LinkedIn in percent",
"type": [
"number",
"null"
]
},
"lastFunding": {
"type": "object",
"properties": {
"type": {
"description": "e.g. Seed Round, Series A, Private Equity Round",
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"amount": {
"description": "USD",
"type": [
"number",
"null"
]
}
},
"required": [
"type",
"date",
"amount"
],
"additionalProperties": false
},
"totalFunding": {
"description": "USD",
"type": [
"number",
"null"
]
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"hqCity": {
"type": [
"string",
"null"
]
},
"hqState": {
"type": [
"string",
"null"
]
},
"hqCountry": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"x": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"x",
"tiktok",
"youtube"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false,
"description": "true/false where the website was checked, null where it never was"
}
},
"required": [
"organizationId",
"name",
"domain",
"website",
"websiteAlive",
"websiteTitle",
"websiteDescription",
"linkedin",
"linkedinDescription",
"description",
"industry",
"naicsCodes",
"keywords",
"technologies",
"employeeCount",
"employeeMin",
"employeeMax",
"revenueRange",
"monthlyVisits",
"monthlyGoogleAdSpend",
"employeeGrowthRate",
"lastFunding",
"totalFunding",
"foundedYear",
"hqCity",
"hqState",
"hqCountry",
"emails",
"phones",
"socials",
"adPixels"
],
"additionalProperties": false
}
}
},
"required": [
"totalCount",
"chargedCredits",
"organizations"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_enrich(domain)
Enrich a company from its domain. Returns the company's firmographics, socials and website data. Charges 0.5 credits only when the company is found. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"minLength": 3,
"description": "Company domain or website URL, e.g. \"stripe.com\""
}
},
"required": [
"domain"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"organization": {
"anyOf": [
{
"type": "object",
"properties": {
"organizationId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"websiteAlive": {
"type": [
"boolean",
"null"
]
},
"websiteTitle": {
"type": [
"string",
"null"
]
},
"websiteDescription": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"linkedinDescription": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"keywords": {
"type": [
"string",
"null"
]
},
"technologies": {
"type": [
"string",
"null"
]
},
"employeeCount": {
"type": [
"number",
"null"
]
},
"employeeMin": {
"type": [
"number",
"null"
]
},
"employeeMax": {
"type": [
"number",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"monthlyVisits": {
"description": "Estimated monthly website visits",
"type": [
"number",
"null"
]
},
"monthlyGoogleAdSpend": {
"description": "Estimated monthly Google Ads spend in USD",
"type": [
"number",
"null"
]
},
"employeeGrowthRate": {
"description": "Employee growth on LinkedIn in percent",
"type": [
"number",
"null"
]
},
"lastFunding": {
"type": "object",
"properties": {
"type": {
"description": "e.g. Seed Round, Series A, Private Equity Round",
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"amount": {
"description": "USD",
"type": [
"number",
"null"
]
}
},
"required": [
"type",
"date",
"amount"
],
"additionalProperties": false
},
"totalFunding": {
"description": "USD",
"type": [
"number",
"null"
]
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"hqCity": {
"type": [
"string",
"null"
]
},
"hqState": {
"type": [
"string",
"null"
]
},
"hqCountry": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Found on the company website"
},
"socials": {
"type": "object",
"properties": {
"facebook": {
"type": [
"string",
"null"
]
},
"instagram": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"x": {
"type": [
"string",
"null"
]
},
"tiktok": {
"type": [
"string",
"null"
]
},
"youtube": {
"type": [
"string",
"null"
]
}
},
"required": [
"facebook",
"instagram",
"linkedin",
"x",
"tiktok",
"youtube"
],
"additionalProperties": false
},
"adPixels": {
"type": "object",
"properties": {
"meta": {
"type": [
"boolean",
"null"
]
},
"googleAds": {
"type": [
"boolean",
"null"
]
},
"googleAnalytics": {
"type": [
"boolean",
"null"
]
},
"tiktok": {
"type": [
"boolean",
"null"
]
},
"chatgpt": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"meta",
"googleAds",
"googleAnalytics",
"tiktok",
"chatgpt"
],
"additionalProperties": false,
"description": "true/false where the website was checked, null where it never was"
}
},
"required": [
"organizationId",
"name",
"domain",
"website",
"websiteAlive",
"websiteTitle",
"websiteDescription",
"linkedin",
"linkedinDescription",
"description",
"industry",
"naicsCodes",
"keywords",
"technologies",
"employeeCount",
"employeeMin",
"employeeMax",
"revenueRange",
"monthlyVisits",
"monthlyGoogleAdSpend",
"employeeGrowthRate",
"lastFunding",
"totalFunding",
"foundedYear",
"hqCity",
"hqState",
"hqCountry",
"emails",
"phones",
"socials",
"adPixels"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"chargedCredits",
"organization"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡organizations_find_decision_maker(organizationId)
Find the decision maker of an organization with a verified email. Charges 2 credits only when a decision maker is found. Can take a few minutes. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"minLength": 1,
"description": "Company ID returned by organization search or enrichment"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"creditsCharged": {
"type": "number"
},
"decisionMaker": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"position": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"name",
"position",
"linkedin",
"email"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"creditsCharged",
"decisionMaker"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_search(query, semantic, domains, hqCountry, hqState, ...)
Search persons with their emails and phones. Returns only people with an email or phone, with full contact data, and charges 1 credit per returned person. Page with nextOffset. limit 0 returns only totalCount, free. saveToContacts also stores them in your contacts, where people you already had are refunded. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text matched against company name, description and keywords",
"type": "string",
"minLength": 1
},
"semantic": {
"description": "What the company is and sells, matched by meaning, e.g. \"outsourced medical billing for clinics\"",
"type": "string",
"minLength": 1
},
"domains": {
"description": "Look companies up by domain, e.g. [\"stripe.com\"]",
"maxItems": 100,
"type": "array",
"items": {
"type": "string"
}
},
"hqCountry": {
"description": "ISO alpha-2 country codes of the headquarters, e.g. [\"US\", \"DE\"]",
"type": "array",
"items": {
"type": "string"
}
},
"hqState": {
"description": "US state names or codes of the headquarters",
"type": "array",
"items": {
"type": "string"
}
},
"employeeBands": {
"description": "Headcount bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1,000",
"1,001-5,000",
"5,001-10,000",
"10,001+"
]
}
},
"revenueRange": {
"description": "Annual company revenue bands",
"type": "array",
"items": {
"type": "string",
"enum": [
"<$1M",
"$1M to <$10M",
"$10M to <$50M",
"$50M to <$100M",
"$100M to <$1B",
"$1B+"
]
}
},
"industryNaicsDirect": {
"description": "NAICS codes",
"type": "array",
"items": {
"type": "string"
}
},
"technologies": {
"description": "Technologies used by the company",
"type": "array",
"items": {
"type": "string"
}
},
"foundedAfter": {
"description": "Earliest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"foundedBefore": {
"description": "Latest founding year to include",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"monthlyVisitsMin": {
"description": "Minimum monthly website visits; known for about 1 in 8 US companies, the rest are excluded",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"employeeGrowthMin": {
"description": "Minimum employee growth on LinkedIn in percent, e.g. 10; known for about 1 in 13 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"fundedAfter": {
"description": "Year of the last funding round, at least; known for about 1 in 100 US companies",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"jobTitle": {
"description": "Matched as partial text, so \"CEO\" also finds \"Assistant to the CEO\"; combine with jobLevel to narrow",
"type": "array",
"items": {
"type": "string"
}
},
"jobTitleExclude": {
"description": "Job title phrases to exclude",
"type": "array",
"items": {
"type": "string"
}
},
"jobLevel": {
"description": "Allowed job seniority levels",
"type": "array",
"items": {
"type": "string",
"enum": [
"C-Team",
"VP",
"Director",
"Manager",
"Staff",
"Other"
]
}
},
"decisionMakersOnly": {
"description": "C-level, VP or director seniority, or a founder, owner, CEO, managing director or president title",
"type": "boolean"
},
"inCountry": {
"description": "ISO alpha-2 country codes where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"personState": {
"description": "States where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"personCity": {
"description": "Cities where the person is based",
"type": "array",
"items": {
"type": "string"
}
},
"organizationIds": {
"description": "Limit to organizations from /organizations/search",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"default": 25,
"description": "Maximum people to return; 0 returns only a free count",
"type": "integer",
"minimum": 0,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Pagination offset; use nextOffset from the previous response",
"type": "integer",
"minimum": 0,
"maximum": 10000
},
"onePerOrganization": {
"default": false,
"description": "Return at most one person per company",
"type": "boolean"
},
"saveToContacts": {
"default": false,
"description": "Save returned people to your Deeplead contacts",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"totalCount": {
"type": "number",
"description": "With limit 0: all matching people, including those without an email or phone"
},
"nextOffset": {
"type": [
"number",
"null"
]
},
"chargedCredits": {
"type": "number"
},
"persons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"personId": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"linkedin": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"jobLevel": {
"type": [
"string",
"null"
]
},
"jobFunction": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"companyMonthlyVisits": {
"type": [
"number",
"null"
]
},
"companyEmployeeGrowthRate": {
"description": "Percent",
"type": [
"number",
"null"
]
},
"companyLastFundingType": {
"type": [
"string",
"null"
]
},
"companyLastFundingDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"personId",
"name",
"email",
"alternateEmails",
"phone",
"phones",
"linkedin",
"jobTitle",
"jobLevel",
"jobFunction",
"city",
"state",
"country",
"organizationId",
"companyName",
"companyWebsite",
"revenueRange",
"naicsCodes",
"foundedYear",
"companyMonthlyVisits",
"companyEmployeeGrowthRate",
"companyLastFundingType",
"companyLastFundingDate"
],
"additionalProperties": false
}
}
},
"required": [
"totalCount",
"nextOffset",
"chargedCredits",
"persons"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_lookup(linkedin, email, name, domain, saveToContacts)
Look up one person by LinkedIn URL, email, or name and company domain. Returns the person with their emails, phones, role and company. Charges 1 credit only when the person is found with an email or phone. saveToContacts also stores them in your contacts. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"email": {
"description": "Known email address identifying the person",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
},
"saveToContacts": {
"default": false,
"description": "Save the returned person to your Deeplead contacts",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"person": {
"anyOf": [
{
"type": "object",
"properties": {
"personId": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"linkedin": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"jobLevel": {
"type": [
"string",
"null"
]
},
"jobFunction": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"revenueRange": {
"type": [
"string",
"null"
]
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"foundedYear": {
"type": [
"number",
"null"
]
},
"companyMonthlyVisits": {
"type": [
"number",
"null"
]
},
"companyEmployeeGrowthRate": {
"description": "Percent",
"type": [
"number",
"null"
]
},
"companyLastFundingType": {
"type": [
"string",
"null"
]
},
"companyLastFundingDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"personId",
"name",
"email",
"alternateEmails",
"phone",
"phones",
"linkedin",
"jobTitle",
"jobLevel",
"jobFunction",
"city",
"state",
"country",
"organizationId",
"companyName",
"companyWebsite",
"revenueRange",
"naicsCodes",
"foundedYear",
"companyMonthlyVisits",
"companyEmployeeGrowthRate",
"companyLastFundingType",
"companyLastFundingDate"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"chargedCredits",
"person"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_find_email(linkedin, name, domain)
Find a person's work email by LinkedIn URL, or full name and company domain. Charges 1 credit only when an email is found. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"email": {
"type": [
"string",
"null"
]
},
"alternateEmails": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
}
},
"required": [
"found",
"chargedCredits",
"email",
"alternateEmails",
"name",
"jobTitle",
"companyName",
"companyWebsite",
"linkedin"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡persons_find_phone(linkedin, email, name, domain)
Find a person's phone number by LinkedIn URL, email, or full name and company domain. Charges 2 credits only when a phone number is found. Send an Idempotency-Key header to make retries safe.
Input Schema
{
"type": "object",
"properties": {
"linkedin": {
"description": "e.g. \"https://www.linkedin.com/in/jane-doe\"",
"type": "string",
"minLength": 1
},
"email": {
"description": "Known email address identifying the person",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"name": {
"description": "Full name, e.g. \"Jane Doe\"; needs domain",
"type": "string",
"minLength": 3
},
"domain": {
"description": "Company domain, e.g. \"acme.com\"",
"type": "string",
"minLength": 3
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"chargedCredits": {
"type": "number"
},
"phone": {
"type": [
"string",
"null"
]
},
"phones": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"companyWebsite": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
}
},
"required": [
"found",
"chargedCredits",
"phone",
"phones",
"name",
"jobTitle",
"companyName",
"companyWebsite",
"linkedin"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡contacts_create(contacts)
Save your own contacts or organizations. Free. Existing contacts are matched and kept, never duplicated.
Input Schema
{
"type": "object",
"properties": {
"contacts": {
"minItems": 1,
"maxItems": 1000,
"type": "array",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"personName": {
"type": "string"
},
"position": {
"type": "string"
},
"businessName": {
"type": "string"
},
"website": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"phone": {
"type": "string"
},
"city": {
"type": "string"
},
"industry": {
"type": "string"
},
"organizationId": {
"description": "From /organizations/search",
"type": "string"
}
}
},
"description": "Contacts to save; each needs an email, LinkedIn URL, website or organization ID"
}
},
"required": [
"contacts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"saved": {
"type": "number"
}
},
"required": [
"saved"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢contacts_list(limit, before)
List your contacts in a stable order; page with nextBefore
Input Schema
{
"type": "object",
"properties": {
"limit": {
"default": 100,
"description": "Maximum saved contacts to return on this page",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"before": {
"description": "The nextBefore of the previous page",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contactId": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"jobTitle": {
"type": [
"string",
"null"
]
},
"companyName": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"linkedin": {
"type": [
"string",
"null"
]
},
"organizationId": {
"type": [
"string",
"null"
]
}
},
"required": [
"contactId",
"name",
"email",
"jobTitle",
"companyName",
"website",
"linkedin",
"organizationId"
],
"additionalProperties": false
}
},
"nextBefore": {
"type": [
"string",
"null"
]
}
},
"required": [
"contacts",
"nextBefore"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢credits_get
Current credit balance
Input Schema
{
"type": "object",
"properties": {}
}Output Schema
{
"type": "object",
"properties": {
"credits": {
"type": "number"
}
},
"required": [
"credits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools