consulti-mcp 2.2.0 → 2.4.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 CHANGED
@@ -3,7 +3,7 @@
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 — **9 stable tools** to search 500M+ B2B leads, verify emails (including catch-all mailbox resolution), enrich leads by email or LinkedIn URL, manage saved lists, and check credit balance.
6
+ MCP server for the Consulti lead intelligence API — **10 stable tools** to search 500M+ B2B leads, search Instagram profiles, verify emails (including catch-all mailbox resolution), enrich leads by email or LinkedIn URL, manage saved lists, and check credit balance.
7
7
 
8
8
  > **Stable surface only.** Beta endpoints (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
9
9
 
@@ -139,6 +139,8 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
139
139
  | `q` | string | Free text search across name, title, company, and industry |
140
140
  | `titles` | string[] | Job titles to filter by (e.g. ["CEO", "VP Marketing"]) |
141
141
  | `industries` | string[] | Industries to filter by (e.g. ["Technology", "Finance"]) |
142
+ | `technologies` | string[] | Website tech, exact Wappalyzer-style names (e.g. ["Shopify"]); OR-matched. Canonical list: `GET /api/v1/meta/technologies` |
143
+ | `excludeTechnologies` | string[] | Website tech to EXCLUDE (same names). A lead is dropped if its company uses ANY listed tech; leads with no technology data are kept |
142
144
  | `countries` | string[] | Countries to filter by (e.g. ["United States"]) |
143
145
  | `states` | string[] | States/regions to filter by (e.g. ["California"]) |
144
146
  | `cities` | string[] | Cities to filter by (e.g. ["San Francisco"]) |
@@ -221,10 +223,8 @@ Check the authenticated user's current lead and verification credit balance. Fre
221
223
  {
222
224
  "success": true,
223
225
  "data": {
224
- "lead_credits": 1000,
225
- "lead_rollover_credits": 0,
226
- "verification_credits": 5000,
227
- "total_lead_credits": 1000
226
+ "lead_credits": 1500,
227
+ "verification_credits": 5000
228
228
  }
229
229
  }
230
230
  ```
@@ -248,7 +248,7 @@ Print the installed version:
248
248
 
249
249
  ```bash
250
250
  npx -y consulti-mcp --version
251
- # → 2.2.0
251
+ # → 2.3.0
252
252
  ```
253
253
 
254
254
  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 = "2.2.0";
5
+ const VERSION = "2.4.0";
6
6
  if (process.argv.includes("--version") || process.argv.includes("-v")) {
7
7
  console.log(VERSION);
8
8
  process.exit(0);
@@ -97,6 +97,8 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
97
97
  q: z.string().optional().describe("Free text search across name, title, company, and industry"),
98
98
  titles: z.array(z.string()).optional().describe("Job titles to filter by (e.g. [\"CEO\", \"VP Marketing\"])"),
99
99
  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"),
100
+ technologies: z.array(z.string()).optional().describe("Technologies the company's website uses, exact Wappalyzer-style names (e.g. [\"Shopify\", \"HubSpot\", \"WordPress\"]). OR-matched: a lead matches if it uses ANY listed technology. Canonical list: GET https://www.consulti.ai/api/v1/meta/technologies"),
101
+ excludeTechnologies: z.array(z.string()).optional().describe("Technologies to EXCLUDE, same Wappalyzer-style names. A lead is dropped if its company uses ANY listed technology; leads with no technology data are kept."),
100
102
  countries: z.array(z.string()).optional().describe("Countries to filter by (exact match). Canonical list: GET https://www.consulti.ai/api/v1/meta/countries"),
101
103
  states: z.array(z.string()).optional().describe("States/regions to filter by (exact match). Canonical list: GET https://www.consulti.ai/api/v1/meta/states"),
102
104
  cities: z.array(z.string()).optional().describe("Cities to filter by (e.g. [\"San Francisco\", \"London\"])"),
@@ -114,6 +116,10 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
114
116
  body.titles = params.titles;
115
117
  if (params.industries)
116
118
  body.industries = params.industries;
119
+ if (params.technologies)
120
+ body.technologies = params.technologies;
121
+ if (params.excludeTechnologies)
122
+ body.excludeTechnologies = params.excludeTechnologies;
117
123
  if (params.countries)
118
124
  body.countries = params.countries;
119
125
  if (params.states)
@@ -136,6 +142,76 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
136
142
  content: [{ type: "text", text: await apiPost("/leads/search", body) }],
137
143
  };
138
144
  });
145
+ server.tool("search_instagram_profiles", "Search a database of Instagram profiles with filters like follower count, category, location, and data quality. 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 operations.", {
146
+ q: z.string().optional().describe("Free text search across username and bio"),
147
+ bioKeywords: z.array(z.string()).optional().describe("Keywords to search for in profile bios"),
148
+ excludeKeywords: z.array(z.string()).optional().describe("Exclude profiles whose bio matches any of these keywords"),
149
+ excludeAdultContent: z.boolean().optional().describe("Exclude profiles with adult/sexual content terms in their bio"),
150
+ followerMin: z.number().optional().describe("Minimum follower count"),
151
+ followerMax: z.number().optional().describe("Maximum follower count"),
152
+ followingMin: z.number().optional().describe("Minimum following count"),
153
+ followingMax: z.number().optional().describe("Maximum following count"),
154
+ postsMin: z.number().optional().describe("Minimum post count"),
155
+ postsMax: z.number().optional().describe("Maximum post count"),
156
+ categories: z.array(z.string()).optional().describe("Categories to filter by (e.g. [\"Fashion\", \"Travel\"]). Canonical list: GET https://www.consulti.ai/api/v1/meta/instagram-categories"),
157
+ accountTypes: z.array(z.string()).optional().describe("Account types to filter by (e.g. [\"business\", \"personal\"])"),
158
+ verified: z.boolean().optional().describe("Filter to only verified accounts"),
159
+ hasEmail: z.boolean().optional().describe("Filter to only accounts with verified email"),
160
+ hasPhone: z.boolean().optional().describe("Filter to only accounts with phone number"),
161
+ hasWebsite: z.boolean().optional().describe("Filter to only accounts with website"),
162
+ countries: z.array(z.string()).optional().describe("Countries to filter by (exact match). Canonical list: GET https://www.consulti.ai/api/v1/meta/instagram-countries"),
163
+ sortBy: z.string().optional().describe("Field to sort by (followers, posts, engagement, username)"),
164
+ sortOrder: z.string().optional().describe("Sort order (asc or desc)"),
165
+ page: z.number().optional().describe("Page number (default: 1)"),
166
+ size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
167
+ }, async (params) => {
168
+ const body = {};
169
+ if (params.q)
170
+ body.q = params.q;
171
+ if (params.bioKeywords)
172
+ body.bioKeywords = params.bioKeywords;
173
+ if (params.excludeKeywords)
174
+ body.excludeKeywords = params.excludeKeywords;
175
+ if (params.excludeAdultContent !== undefined)
176
+ body.excludeAdultContent = params.excludeAdultContent;
177
+ if (params.followerMin !== undefined)
178
+ body.followerMin = params.followerMin;
179
+ if (params.followerMax !== undefined)
180
+ body.followerMax = params.followerMax;
181
+ if (params.followingMin !== undefined)
182
+ body.followingMin = params.followingMin;
183
+ if (params.followingMax !== undefined)
184
+ body.followingMax = params.followingMax;
185
+ if (params.postsMin !== undefined)
186
+ body.postsMin = params.postsMin;
187
+ if (params.postsMax !== undefined)
188
+ body.postsMax = params.postsMax;
189
+ if (params.categories)
190
+ body.categories = params.categories;
191
+ if (params.accountTypes)
192
+ body.accountTypes = params.accountTypes;
193
+ if (params.verified !== undefined)
194
+ body.verified = params.verified;
195
+ if (params.hasEmail !== undefined)
196
+ body.hasEmail = params.hasEmail;
197
+ if (params.hasPhone !== undefined)
198
+ body.hasPhone = params.hasPhone;
199
+ if (params.hasWebsite !== undefined)
200
+ body.hasWebsite = params.hasWebsite;
201
+ if (params.countries)
202
+ body.countries = params.countries;
203
+ if (params.sortBy)
204
+ body.sortBy = params.sortBy;
205
+ if (params.sortOrder)
206
+ body.sortOrder = params.sortOrder;
207
+ if (params.page !== undefined)
208
+ body.page = params.page;
209
+ if (params.size !== undefined)
210
+ body.size = params.size;
211
+ return {
212
+ content: [{ type: "text", text: await apiPost("/instagram/search", body) }],
213
+ };
214
+ });
139
215
  server.tool("get_lists", "Get all saved lead lists for the authenticated user, with member counts", {}, async () => ({
140
216
  content: [{ type: "text", text: await apiGet("/lists") }],
141
217
  }));
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "consulti-mcp",
3
- "version": "2.2.0",
4
- "description": "Consulti.ai MCP server — 9 stable tools for email verification (incl. catch-all mailbox resolution), B2B lead search/enrichment, LinkedIn-URL 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.",
3
+ "version": "2.4.0",
4
+ "description": "Consulti.ai MCP server — 10 stable tools for email verification (incl. catch-all mailbox resolution), B2B lead search/enrichment, LinkedIn-URL enrichment, Instagram profile search, 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"