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.
Files changed (3) hide show
  1. package/README.md +10 -94
  2. package/dist/index.js +4 -107
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -3,7 +3,9 @@
3
3
  [![npm version](https://img.shields.io/npm/v/consulti-mcp.svg)](https://www.npmjs.com/package/consulti-mcp)
4
4
  [![license](https://img.shields.io/npm/l/consulti-mcp.svg)](./LICENSE)
5
5
 
6
- MCP server for the Consulti lead intelligence API — 11 tools to search 500M+ B2B leads, local businesses, and creators; verify emails; find and enrich leads; manage saved lists; and check your credit balance.
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
- # → 1.1.0
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 = "1.1.0";
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("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
- 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": "1.1.0",
4
- "description": "Consulti.ai MCP server — 11 tools for lead enrichment, email verification, credit-balance checks, and B2B/local/creator database search across Claude Desktop, Cursor, and any MCP-compatible client.",
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"