consulti-mcp 2.3.0 → 2.4.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 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
 
@@ -223,10 +223,8 @@ Check the authenticated user's current lead and verification credit balance. Fre
223
223
  {
224
224
  "success": true,
225
225
  "data": {
226
- "lead_credits": 1000,
227
- "lead_rollover_credits": 0,
228
- "verification_credits": 5000,
229
- "total_lead_credits": 1000
226
+ "lead_credits": 1500,
227
+ "verification_credits": 5000
230
228
  }
231
229
  }
232
230
  ```
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.3.0";
5
+ const VERSION = "2.4.1";
6
6
  if (process.argv.includes("--version") || process.argv.includes("-v")) {
7
7
  console.log(VERSION);
8
8
  process.exit(0);
@@ -142,6 +142,79 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
142
142
  content: [{ type: "text", text: await apiPost("/leads/search", body) }],
143
143
  };
144
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. [\"Digital creator\", \"Photographer\"]). 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\"]). Canonical list: GET https://www.consulti.ai/api/v1/meta/instagram-account-types"),
158
+ emailStatus: z.array(z.string()).optional().describe("Email verification status to filter by (e.g. [\"good\", \"risky\", \"bad\", \"catch_all\"]). Canonical list: GET https://www.consulti.ai/api/v1/meta/instagram-email-statuses"),
159
+ verified: z.boolean().optional().describe("Filter to only verified accounts"),
160
+ hasEmail: z.boolean().optional().describe("Filter to only accounts with an email on file"),
161
+ hasPhone: z.boolean().optional().describe("Filter to only accounts with phone number"),
162
+ hasWebsite: z.boolean().optional().describe("Filter to only accounts with website"),
163
+ 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"),
164
+ sortBy: z.string().optional().describe("Field to sort by (followers, posts, engagement, username)"),
165
+ sortOrder: z.string().optional().describe("Sort order (asc or desc)"),
166
+ page: z.number().optional().describe("Page number (default: 1)"),
167
+ size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
168
+ }, async (params) => {
169
+ const body = {};
170
+ if (params.q)
171
+ body.q = params.q;
172
+ if (params.bioKeywords)
173
+ body.bioKeywords = params.bioKeywords;
174
+ if (params.excludeKeywords)
175
+ body.excludeKeywords = params.excludeKeywords;
176
+ if (params.excludeAdultContent !== undefined)
177
+ body.excludeAdultContent = params.excludeAdultContent;
178
+ if (params.followerMin !== undefined)
179
+ body.followerMin = params.followerMin;
180
+ if (params.followerMax !== undefined)
181
+ body.followerMax = params.followerMax;
182
+ if (params.followingMin !== undefined)
183
+ body.followingMin = params.followingMin;
184
+ if (params.followingMax !== undefined)
185
+ body.followingMax = params.followingMax;
186
+ if (params.postsMin !== undefined)
187
+ body.postsMin = params.postsMin;
188
+ if (params.postsMax !== undefined)
189
+ body.postsMax = params.postsMax;
190
+ if (params.categories)
191
+ body.categories = params.categories;
192
+ if (params.accountTypes)
193
+ body.accountTypes = params.accountTypes;
194
+ if (params.emailStatus)
195
+ body.emailStatus = params.emailStatus;
196
+ if (params.verified !== undefined)
197
+ body.verified = params.verified;
198
+ if (params.hasEmail !== undefined)
199
+ body.hasEmail = params.hasEmail;
200
+ if (params.hasPhone !== undefined)
201
+ body.hasPhone = params.hasPhone;
202
+ if (params.hasWebsite !== undefined)
203
+ body.hasWebsite = params.hasWebsite;
204
+ if (params.countries)
205
+ body.countries = params.countries;
206
+ if (params.sortBy)
207
+ body.sortBy = params.sortBy;
208
+ if (params.sortOrder)
209
+ body.sortOrder = params.sortOrder;
210
+ if (params.page !== undefined)
211
+ body.page = params.page;
212
+ if (params.size !== undefined)
213
+ body.size = params.size;
214
+ return {
215
+ content: [{ type: "text", text: await apiPost("/instagram/search", body) }],
216
+ };
217
+ });
145
218
  server.tool("get_lists", "Get all saved lead lists for the authenticated user, with member counts", {}, async () => ({
146
219
  content: [{ type: "text", text: await apiGet("/lists") }],
147
220
  }));
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "consulti-mcp",
3
- "version": "2.3.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.1",
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"