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 +6 -6
- package/dist/index.js +77 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
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 — **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":
|
|
225
|
-
"
|
|
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.
|
|
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.
|
|
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.
|
|
4
|
-
"description": "Consulti.ai MCP server —
|
|
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"
|