consulti-mcp 1.1.0 → 2.0.1
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 +10 -94
- package/dist/index.js +4 -107
- 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
|
|
|
@@ -55,6 +57,8 @@ Add to `.cursor/mcp.json`:
|
|
|
55
57
|
|
|
56
58
|
Verify if an email address is valid and deliverable.
|
|
57
59
|
|
|
60
|
+
**Cost:** 1 verification credit per call.
|
|
61
|
+
|
|
58
62
|
| Input | Type | Description |
|
|
59
63
|
| ------- | ------ | --------------------------- |
|
|
60
64
|
| `email` | string | The email address to verify |
|
|
@@ -64,38 +68,12 @@ Verify if an email address is valid and deliverable.
|
|
|
64
68
|
{ "email": "john@example.com" }
|
|
65
69
|
```
|
|
66
70
|
|
|
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
71
|
### enrich_lead
|
|
96
72
|
|
|
97
73
|
Enrich a lead's full profile using their email address.
|
|
98
74
|
|
|
75
|
+
**Cost:** 1 lead credit — only deducted on a successful match; 404 responses are free.
|
|
76
|
+
|
|
99
77
|
| Input | Type | Description |
|
|
100
78
|
| ------- | ------ | --------------------------------------- |
|
|
101
79
|
| `email` | string | The email address of the lead to enrich |
|
|
@@ -109,6 +87,8 @@ Enrich a lead's full profile using their email address.
|
|
|
109
87
|
|
|
110
88
|
Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. All inputs are optional.
|
|
111
89
|
|
|
90
|
+
**Cost:** 1 lead credit per result returned. Credits are reserved up to `size` then refunded down to the actual row count; 0 results = 0 credits. Call `get_credits` first before using large `size` values.
|
|
91
|
+
|
|
112
92
|
| Input | Type | Description |
|
|
113
93
|
| ---------------- | -------- | ------------------------------------------------------------------ |
|
|
114
94
|
| `q` | string | Free text search across name, title, company, and industry |
|
|
@@ -143,70 +123,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
143
123
|
}
|
|
144
124
|
```
|
|
145
125
|
|
|
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
126
|
### get_lists
|
|
211
127
|
|
|
212
128
|
Get all saved lead lists for the authenticated user, with member counts. No inputs required.
|
|
@@ -289,7 +205,7 @@ Print the installed version:
|
|
|
289
205
|
|
|
290
206
|
```bash
|
|
291
207
|
npx -y consulti-mcp --version
|
|
292
|
-
# →
|
|
208
|
+
# → 2.0.0
|
|
293
209
|
```
|
|
294
210
|
|
|
295
211
|
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);
|
|
@@ -81,23 +81,13 @@ const server = new McpServer({
|
|
|
81
81
|
name: "consulti-mcp",
|
|
82
82
|
version: VERSION,
|
|
83
83
|
});
|
|
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 }) => ({
|
|
84
|
+
server.tool("verify_email", "Verify if an email address is valid and deliverable. Cost: 1 verification credit per call.", { 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("
|
|
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
|
-
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 }) => ({
|
|
87
|
+
server.tool("enrich_lead", "Enrich a lead's full profile using their email address. Cost: 1 lead credit — only deducted on a successful match; 404 responses are free.", { 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
|
}));
|
|
100
|
-
server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size", {
|
|
90
|
+
server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. Cost: 1 lead credit per result returned — reserved up to `size` then refunded down to the actual row count; 0 results = 0 credits. Call get_credits first before large `size` values.", {
|
|
101
91
|
q: z.string().optional().describe("Free text search across name, title, company, and industry"),
|
|
102
92
|
titles: z.array(z.string()).optional().describe("Job titles to filter by (e.g. [\"CEO\", \"VP Marketing\"])"),
|
|
103
93
|
industries: z.array(z.string()).optional().describe("Industries to filter by (case-sensitive exact match). Get the canonical list: GET https://www.consulti.ai/api/v1/meta/industries"),
|
|
@@ -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.1",
|
|
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"
|