consulti-mcp 1.1.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -94
- package/dist/index.js +1 -104
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -3,7 +3,9 @@
|
|
|
3
3
|
[](https://www.npmjs.com/package/consulti-mcp)
|
|
4
4
|
[](./LICENSE)
|
|
5
5
|
|
|
6
|
-
MCP server for the Consulti lead intelligence API —
|
|
6
|
+
MCP server for the Consulti lead intelligence API — **7 stable tools** to search 500M+ B2B leads, verify emails, enrich leads, manage saved lists, and check credit balance.
|
|
7
|
+
|
|
8
|
+
> **Stable surface only.** Beta endpoints (LinkedIn lookup, name-domain lookup, local-business search, creator search) are intentionally NOT exposed via MCP — their schemas may change. To use them, call the REST API directly: https://www.consulti.ai/api-docs
|
|
7
9
|
|
|
8
10
|
## Installation
|
|
9
11
|
|
|
@@ -64,34 +66,6 @@ Verify if an email address is valid and deliverable.
|
|
|
64
66
|
{ "email": "john@example.com" }
|
|
65
67
|
```
|
|
66
68
|
|
|
67
|
-
### find_lead_by_linkedin
|
|
68
|
-
|
|
69
|
-
Find and enrich a lead by their LinkedIn profile URL.
|
|
70
|
-
|
|
71
|
-
| Input | Type | Description |
|
|
72
|
-
| -------------- | ------ | ------------------------------------ |
|
|
73
|
-
| `linkedin_url` | string | The LinkedIn profile URL of the lead |
|
|
74
|
-
|
|
75
|
-
**Example:**
|
|
76
|
-
```json
|
|
77
|
-
{ "linkedin_url": "https://linkedin.com/in/johndoe" }
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
### find_lead_by_name
|
|
81
|
-
|
|
82
|
-
Find a lead's email by their name and company domain.
|
|
83
|
-
|
|
84
|
-
| Input | Type | Description |
|
|
85
|
-
| ------------ | ------ | ------------------------------------- |
|
|
86
|
-
| `first_name` | string | The lead's first name |
|
|
87
|
-
| `last_name` | string | The lead's last name |
|
|
88
|
-
| `domain` | string | The company domain (e.g. example.com) |
|
|
89
|
-
|
|
90
|
-
**Example:**
|
|
91
|
-
```json
|
|
92
|
-
{ "first_name": "John", "last_name": "Doe", "domain": "example.com" }
|
|
93
|
-
```
|
|
94
|
-
|
|
95
69
|
### enrich_lead
|
|
96
70
|
|
|
97
71
|
Enrich a lead's full profile using their email address.
|
|
@@ -143,70 +117,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
143
117
|
}
|
|
144
118
|
```
|
|
145
119
|
|
|
146
|
-
### search_local_leads
|
|
147
|
-
|
|
148
|
-
Search a database of local businesses scraped from Google Maps, with owner emails, ratings, and reviews. All inputs are optional.
|
|
149
|
-
|
|
150
|
-
| Input | Type | Description |
|
|
151
|
-
| ------------ | -------- | --------------------------------------------------------------- |
|
|
152
|
-
| `q` | string | Free text search across business name and category |
|
|
153
|
-
| `name` | string | Business name to search for |
|
|
154
|
-
| `keywords` | string[] | Keywords to match in name or category |
|
|
155
|
-
| `states` | string[] | US states (full name or abbreviation, e.g. ["California"] or ["CA"]) |
|
|
156
|
-
| `cities` | string[] | Cities to filter by |
|
|
157
|
-
| `zips` | string[] | ZIP codes to filter by |
|
|
158
|
-
| `ratingMin` | number | Minimum Google rating (0-5) |
|
|
159
|
-
| `ratingMax` | number | Maximum Google rating (0-5) |
|
|
160
|
-
| `reviewsMin` | number | Minimum number of Google reviews |
|
|
161
|
-
| `reviewsMax` | number | Maximum number of Google reviews |
|
|
162
|
-
| `hasEmail` | boolean | Only return businesses with a verified email |
|
|
163
|
-
| `hasPhone` | boolean | Only return businesses with a phone number |
|
|
164
|
-
| `hasWeb` | boolean | Only return businesses with a website |
|
|
165
|
-
| `page` | number | Page number (default: 1) |
|
|
166
|
-
| `size` | number | Results per page (default: 25, max: 100) |
|
|
167
|
-
|
|
168
|
-
**Example:**
|
|
169
|
-
```json
|
|
170
|
-
{
|
|
171
|
-
"keywords": ["plumber"],
|
|
172
|
-
"states": ["California"],
|
|
173
|
-
"cities": ["Los Angeles"],
|
|
174
|
-
"ratingMin": 4.0,
|
|
175
|
-
"hasEmail": true,
|
|
176
|
-
"size": 25
|
|
177
|
-
}
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
### search_creator_leads
|
|
181
|
-
|
|
182
|
-
Search a database of 2.6M+ podcasts and 62K+ YouTube channels with contact emails.
|
|
183
|
-
|
|
184
|
-
| Input | Type | Description |
|
|
185
|
-
| ---------------- | -------- | -------------------------------------------------- |
|
|
186
|
-
| `source` | string | **Required.** Creator source: "youtube" or "podcast" |
|
|
187
|
-
| `q` | string | Free text search across creator name/description |
|
|
188
|
-
| `hasEmail` | boolean | Only return creators with an email |
|
|
189
|
-
| `categories` | string[] | Podcast categories to filter by |
|
|
190
|
-
| `niches` | string[] | YouTube niches to filter by |
|
|
191
|
-
| `country` | string | Country code (e.g. "US") |
|
|
192
|
-
| `language` | string | Podcast language code (e.g. "en") |
|
|
193
|
-
| `minSubscribers` | number | Minimum YouTube subscriber count |
|
|
194
|
-
| `maxSubscribers` | number | Maximum YouTube subscriber count |
|
|
195
|
-
| `minEpisodes` | number | Minimum podcast episode count |
|
|
196
|
-
| `page` | number | Page number (default: 1) |
|
|
197
|
-
| `size` | number | Results per page (default: 25, max: 100) |
|
|
198
|
-
|
|
199
|
-
**Example:**
|
|
200
|
-
```json
|
|
201
|
-
{
|
|
202
|
-
"source": "youtube",
|
|
203
|
-
"niches": ["Technology"],
|
|
204
|
-
"hasEmail": true,
|
|
205
|
-
"minSubscribers": 10000,
|
|
206
|
-
"size": 25
|
|
207
|
-
}
|
|
208
|
-
```
|
|
209
|
-
|
|
210
120
|
### get_lists
|
|
211
121
|
|
|
212
122
|
Get all saved lead lists for the authenticated user, with member counts. No inputs required.
|
|
@@ -289,7 +199,7 @@ Print the installed version:
|
|
|
289
199
|
|
|
290
200
|
```bash
|
|
291
201
|
npx -y consulti-mcp --version
|
|
292
|
-
# →
|
|
202
|
+
# → 2.0.0
|
|
293
203
|
```
|
|
294
204
|
|
|
295
205
|
Releases are published to npm via [GitHub Actions trusted publishing](https://docs.npmjs.com/trusted-publishers) on tags matching `mcp-v*` — each release carries an [npm provenance attestation](https://docs.npmjs.com/generating-provenance-statements).
|
package/dist/index.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
3
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
4
4
|
import { z } from "zod";
|
|
5
|
-
const VERSION = "
|
|
5
|
+
const VERSION = "2.0.0";
|
|
6
6
|
if (process.argv.includes("--version") || process.argv.includes("-v")) {
|
|
7
7
|
console.log(VERSION);
|
|
8
8
|
process.exit(0);
|
|
@@ -84,16 +84,6 @@ const server = new McpServer({
|
|
|
84
84
|
server.tool("verify_email", "Verify if an email address is valid and deliverable", { email: z.string().describe("The email address to verify") }, async ({ email }) => ({
|
|
85
85
|
content: [{ type: "text", text: await apiPost("/verify", { email }) }],
|
|
86
86
|
}));
|
|
87
|
-
server.tool("find_lead_by_linkedin", "Find and enrich a lead by their LinkedIn profile URL", { linkedin_url: z.string().describe("The LinkedIn profile URL of the lead") }, async ({ linkedin_url }) => ({
|
|
88
|
-
content: [{ type: "text", text: await apiPost("/leads/find-by-linkedin", { linkedin_url }) }],
|
|
89
|
-
}));
|
|
90
|
-
server.tool("find_lead_by_name", "Find a lead's email by their name and company domain", {
|
|
91
|
-
first_name: z.string().describe("The lead's first name"),
|
|
92
|
-
last_name: z.string().describe("The lead's last name"),
|
|
93
|
-
domain: z.string().describe("The company domain (e.g. example.com)"),
|
|
94
|
-
}, async ({ first_name, last_name, domain }) => ({
|
|
95
|
-
content: [{ type: "text", text: await apiPost("/leads/find-by-name", { first_name, last_name, domain }) }],
|
|
96
|
-
}));
|
|
97
87
|
server.tool("enrich_lead", "Enrich a lead's full profile using their email address", { email: z.string().describe("The email address of the lead to enrich") }, async ({ email }) => ({
|
|
98
88
|
content: [{ type: "text", text: await apiPost("/leads/enrich", { email }) }],
|
|
99
89
|
}));
|
|
@@ -143,99 +133,6 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
|
|
|
143
133
|
content: [{ type: "text", text: await apiPost("/leads/search", body) }],
|
|
144
134
|
};
|
|
145
135
|
});
|
|
146
|
-
server.tool("search_local_leads", "Search a database of local businesses scraped from Google Maps, with owner emails, ratings, and reviews", {
|
|
147
|
-
q: z.string().optional().describe("Free text search across business name and category"),
|
|
148
|
-
name: z.string().optional().describe("Business name to search for"),
|
|
149
|
-
keywords: z.array(z.string()).optional().describe("Keywords to match in name or category"),
|
|
150
|
-
states: z.array(z.string()).optional().describe("US states. Accepts full names (e.g. [\"California\"]) or 2-letter abbreviations (e.g. [\"CA\"]). Canonical 2-letter list: GET https://www.consulti.ai/api/v1/meta/local-states"),
|
|
151
|
-
cities: z.array(z.string()).optional().describe("Cities to filter by"),
|
|
152
|
-
zips: z.array(z.string()).optional().describe("ZIP codes to filter by"),
|
|
153
|
-
ratingMin: z.number().optional().describe("Minimum Google rating (0-5)"),
|
|
154
|
-
ratingMax: z.number().optional().describe("Maximum Google rating (0-5)"),
|
|
155
|
-
reviewsMin: z.number().optional().describe("Minimum number of Google reviews"),
|
|
156
|
-
reviewsMax: z.number().optional().describe("Maximum number of Google reviews"),
|
|
157
|
-
hasEmail: z.boolean().optional().describe("Only return businesses with a verified email"),
|
|
158
|
-
hasPhone: z.boolean().optional().describe("Only return businesses with a phone number"),
|
|
159
|
-
hasWeb: z.boolean().optional().describe("Only return businesses with a website"),
|
|
160
|
-
page: z.number().optional().describe("Page number (default: 1)"),
|
|
161
|
-
size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
|
|
162
|
-
}, async (params) => {
|
|
163
|
-
const body = {};
|
|
164
|
-
if (params.q)
|
|
165
|
-
body.q = params.q;
|
|
166
|
-
if (params.name)
|
|
167
|
-
body.name = params.name;
|
|
168
|
-
if (params.keywords)
|
|
169
|
-
body.keywords = params.keywords;
|
|
170
|
-
if (params.states)
|
|
171
|
-
body.states = params.states;
|
|
172
|
-
if (params.cities)
|
|
173
|
-
body.cities = params.cities;
|
|
174
|
-
if (params.zips)
|
|
175
|
-
body.zips = params.zips;
|
|
176
|
-
if (params.ratingMin !== undefined)
|
|
177
|
-
body.ratingMin = params.ratingMin;
|
|
178
|
-
if (params.ratingMax !== undefined)
|
|
179
|
-
body.ratingMax = params.ratingMax;
|
|
180
|
-
if (params.reviewsMin !== undefined)
|
|
181
|
-
body.reviewsMin = params.reviewsMin;
|
|
182
|
-
if (params.reviewsMax !== undefined)
|
|
183
|
-
body.reviewsMax = params.reviewsMax;
|
|
184
|
-
if (params.hasEmail !== undefined)
|
|
185
|
-
body.hasEmail = params.hasEmail;
|
|
186
|
-
if (params.hasPhone !== undefined)
|
|
187
|
-
body.hasPhone = params.hasPhone;
|
|
188
|
-
if (params.hasWeb !== undefined)
|
|
189
|
-
body.hasWeb = params.hasWeb;
|
|
190
|
-
if (params.page !== undefined)
|
|
191
|
-
body.page = params.page;
|
|
192
|
-
if (params.size !== undefined)
|
|
193
|
-
body.size = params.size;
|
|
194
|
-
return {
|
|
195
|
-
content: [{ type: "text", text: await apiPost("/local-leads/search", body) }],
|
|
196
|
-
};
|
|
197
|
-
});
|
|
198
|
-
server.tool("search_creator_leads", "Search a database of 2.6M+ podcasts and 62K+ YouTube channels with contact emails", {
|
|
199
|
-
source: z.enum(["youtube", "podcast"]).describe("Creator source: 'youtube' or 'podcast'"),
|
|
200
|
-
q: z.string().optional().describe("Free text search across creator name/description"),
|
|
201
|
-
hasEmail: z.boolean().optional().describe("Only return creators with an email"),
|
|
202
|
-
categories: z.array(z.string()).optional().describe("Podcast categories to filter by (exact match against the categories[] array). Canonical list: GET https://www.consulti.ai/api/v1/meta/creator-podcast-categories"),
|
|
203
|
-
niches: z.array(z.string()).optional().describe("YouTube niches to filter by (fuzzy ILIKE match). Common values: GET https://www.consulti.ai/api/v1/meta/creator-youtube-niches"),
|
|
204
|
-
country: z.string().optional().describe("YouTube country — comma-separated ISO codes (e.g. 'US' or 'US,GB'). Canonical list: GET https://www.consulti.ai/api/v1/meta/creator-countries"),
|
|
205
|
-
language: z.string().optional().describe("Podcast language code (e.g. 'en'). Canonical list: GET https://www.consulti.ai/api/v1/meta/creator-languages"),
|
|
206
|
-
minSubscribers: z.number().optional().describe("Minimum YouTube subscriber count"),
|
|
207
|
-
maxSubscribers: z.number().optional().describe("Maximum YouTube subscriber count"),
|
|
208
|
-
minEpisodes: z.number().optional().describe("Minimum podcast episode count"),
|
|
209
|
-
page: z.number().optional().describe("Page number (default: 1)"),
|
|
210
|
-
size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
|
|
211
|
-
}, async (params) => {
|
|
212
|
-
const body = { source: params.source };
|
|
213
|
-
if (params.q)
|
|
214
|
-
body.q = params.q;
|
|
215
|
-
if (params.hasEmail !== undefined)
|
|
216
|
-
body.hasEmail = params.hasEmail;
|
|
217
|
-
if (params.categories)
|
|
218
|
-
body.categories = params.categories;
|
|
219
|
-
if (params.niches)
|
|
220
|
-
body.niches = params.niches;
|
|
221
|
-
if (params.country)
|
|
222
|
-
body.country = params.country;
|
|
223
|
-
if (params.language)
|
|
224
|
-
body.language = params.language;
|
|
225
|
-
if (params.minSubscribers !== undefined)
|
|
226
|
-
body.minSubscribers = params.minSubscribers;
|
|
227
|
-
if (params.maxSubscribers !== undefined)
|
|
228
|
-
body.maxSubscribers = params.maxSubscribers;
|
|
229
|
-
if (params.minEpisodes !== undefined)
|
|
230
|
-
body.minEpisodes = params.minEpisodes;
|
|
231
|
-
if (params.page !== undefined)
|
|
232
|
-
body.page = params.page;
|
|
233
|
-
if (params.size !== undefined)
|
|
234
|
-
body.size = params.size;
|
|
235
|
-
return {
|
|
236
|
-
content: [{ type: "text", text: await apiPost("/creator-leads/search", body) }],
|
|
237
|
-
};
|
|
238
|
-
});
|
|
239
136
|
server.tool("get_lists", "Get all saved lead lists for the authenticated user, with member counts", {}, async () => ({
|
|
240
137
|
content: [{ type: "text", text: await apiGet("/lists") }],
|
|
241
138
|
}));
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "consulti-mcp",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Consulti.ai MCP server —
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Consulti.ai MCP server — 7 stable tools for email verification, B2B lead search/enrichment, list management, and credit-balance checks. Stable surface only; beta endpoints are not exposed via MCP. Compatible with Claude Desktop, Cursor, and any MCP client.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"consulti-mcp": "dist/index.js"
|