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.
Files changed (3) hide show
  1. package/README.md +4 -94
  2. package/dist/index.js +1 -104
  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
 
@@ -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
- # → 1.1.0
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 = "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);
@@ -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": "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.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"