consulti-mcp 2.0.1 → 2.2.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 +49 -6
- package/dist/index.js +8 -5
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
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 — **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.
|
|
7
7
|
|
|
8
|
-
> **Stable surface only.** Beta endpoints (
|
|
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
|
|
|
10
10
|
## Installation
|
|
11
11
|
|
|
@@ -68,6 +68,36 @@ Verify if an email address is valid and deliverable.
|
|
|
68
68
|
{ "email": "john@example.com" }
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
+
### verify_catchall
|
|
72
|
+
|
|
73
|
+
Resolve whether a specific mailbox on a catch-all domain actually exists — the ESP-engine probe that plain SMTP (`verify_email`) cannot do. Use it on addresses `verify_email` returns with `is_catch_all: true`.
|
|
74
|
+
|
|
75
|
+
**Cost:** 5 verification credits per call (charged on success, including cache hits; refunded on a 500). Requires a plan with catch-all verification enabled (Pro or higher).
|
|
76
|
+
|
|
77
|
+
| Input | Type | Description |
|
|
78
|
+
| ------- | ------ | ------------------------------------------------- |
|
|
79
|
+
| `email` | string | The email address on a catch-all domain to resolve |
|
|
80
|
+
|
|
81
|
+
**Example:**
|
|
82
|
+
```json
|
|
83
|
+
{ "email": "john@catchall-domain.com" }
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
**Response shape:**
|
|
87
|
+
```json
|
|
88
|
+
{
|
|
89
|
+
"success": true,
|
|
90
|
+
"data": {
|
|
91
|
+
"email": "john@catchall-domain.com",
|
|
92
|
+
"status": "good",
|
|
93
|
+
"is_catch_all": true,
|
|
94
|
+
"catch_all_verification": { "score": 95, "status": "Deliverable", "provider": "consulti" },
|
|
95
|
+
"credits_used": 5,
|
|
96
|
+
"cached": false
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
71
101
|
### enrich_lead
|
|
72
102
|
|
|
73
103
|
Enrich a lead's full profile using their email address.
|
|
@@ -83,9 +113,24 @@ Enrich a lead's full profile using their email address.
|
|
|
83
113
|
{ "email": "john@example.com" }
|
|
84
114
|
```
|
|
85
115
|
|
|
116
|
+
### enrich_linkedin
|
|
117
|
+
|
|
118
|
+
Enrich a person by their LinkedIn profile URL → a verified work email plus their US mobile phone (free add-on). Cache-first: served instantly when we already hold a verified email for that profile, otherwise enriched live and cached.
|
|
119
|
+
|
|
120
|
+
**Cost:** 1 lead credit — charged only when an email is returned; phone-only or no-match responses are free.
|
|
121
|
+
|
|
122
|
+
| Input | Type | Description |
|
|
123
|
+
| -------------- | ------ | ------------------------------------------------------ |
|
|
124
|
+
| `linkedin_url` | string | The LinkedIn profile URL, e.g. https://linkedin.com/in/johndoe |
|
|
125
|
+
|
|
126
|
+
**Example:**
|
|
127
|
+
```json
|
|
128
|
+
{ "linkedin_url": "https://linkedin.com/in/johndoe" }
|
|
129
|
+
```
|
|
130
|
+
|
|
86
131
|
### search_b2b_leads
|
|
87
132
|
|
|
88
|
-
Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. All inputs are optional.
|
|
133
|
+
Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. All inputs are optional. Results are always restricted to leads carrying our verified email label — there is no option to include unverified leads.
|
|
89
134
|
|
|
90
135
|
**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
136
|
|
|
@@ -100,7 +145,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
100
145
|
| `company` | string | Company name to search for |
|
|
101
146
|
| `empMin` | number | Minimum employee count |
|
|
102
147
|
| `empMax` | number | Maximum employee count |
|
|
103
|
-
| `emailStatus` | string | One of `good`, `valid`, `risky`, `bad`, `invalid`, `unknown`, `verified`, `all` (default: `all`). `verified` is a legacy alias retained for backward compatibility. Canonical list: `GET https://www.consulti.ai/api/v1/meta/email-statuses` |
|
|
104
148
|
| `excludeListId` | string | UUID of a saved list owned by the API key holder — leads in this list will be excluded from results. Canonical singular field name; `exclude_list_id` and other variants return HTTP 400. |
|
|
105
149
|
| `page` | number | Page number (default: 1) |
|
|
106
150
|
| `size` | number | Results per page (default: 25, max: 100) |
|
|
@@ -117,7 +161,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
117
161
|
"countries": ["United States"],
|
|
118
162
|
"empMin": 50,
|
|
119
163
|
"empMax": 500,
|
|
120
|
-
"emailStatus": "verified",
|
|
121
164
|
"excludeListId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
122
165
|
"size": 25
|
|
123
166
|
}
|
|
@@ -205,7 +248,7 @@ Print the installed version:
|
|
|
205
248
|
|
|
206
249
|
```bash
|
|
207
250
|
npx -y consulti-mcp --version
|
|
208
|
-
# → 2.
|
|
251
|
+
# → 2.2.0
|
|
209
252
|
```
|
|
210
253
|
|
|
211
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.2.0";
|
|
6
6
|
if (process.argv.includes("--version") || process.argv.includes("-v")) {
|
|
7
7
|
console.log(VERSION);
|
|
8
8
|
process.exit(0);
|
|
@@ -84,10 +84,16 @@ const server = new McpServer({
|
|
|
84
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("verify_catchall", "Resolve whether a specific mailbox on a catch-all domain actually exists — the ESP-engine probe that plain SMTP (verify_email) cannot do. Use it on addresses verify_email returns with is_catch_all=true. Cost: 5 verification credits per call; requires a plan with catch-all verification enabled (Pro or higher).", { email: z.string().describe("The email address on a catch-all domain to resolve") }, async ({ email }) => ({
|
|
88
|
+
content: [{ type: "text", text: await apiPost("/verify/catchall", { email }) }],
|
|
89
|
+
}));
|
|
87
90
|
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 }) => ({
|
|
88
91
|
content: [{ type: "text", text: await apiPost("/leads/enrich", { email }) }],
|
|
89
92
|
}));
|
|
90
|
-
server.tool("
|
|
93
|
+
server.tool("enrich_linkedin", "Enrich a person by their LinkedIn profile URL → a verified work email plus their US mobile phone (free add-on). Cache-first: served instantly when we already hold a verified email for that profile, otherwise enriched live and cached. Cost: 1 lead credit — charged ONLY when an email is returned; phone-only or no-match responses are free.", { linkedin_url: z.string().describe("The LinkedIn profile URL, e.g. https://linkedin.com/in/johndoe") }, async ({ linkedin_url }) => ({
|
|
94
|
+
content: [{ type: "text", text: await apiPost("/enrich/linkedin", { linkedin_url }) }],
|
|
95
|
+
}));
|
|
96
|
+
server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. Results are always restricted to leads carrying our verified email label (there is no option to include unverified leads). 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.", {
|
|
91
97
|
q: z.string().optional().describe("Free text search across name, title, company, and industry"),
|
|
92
98
|
titles: z.array(z.string()).optional().describe("Job titles to filter by (e.g. [\"CEO\", \"VP Marketing\"])"),
|
|
93
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"),
|
|
@@ -97,7 +103,6 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
|
|
|
97
103
|
company: z.string().optional().describe("Company name to search for"),
|
|
98
104
|
empMin: z.number().optional().describe("Minimum employee count"),
|
|
99
105
|
empMax: z.number().optional().describe("Maximum employee count"),
|
|
100
|
-
emailStatus: z.enum(["good", "valid", "risky", "bad", "invalid", "unknown", "verified", "all"]).optional().describe("Filter by email verification status. 'all' (default) returns every status. 'verified' is a legacy alias retained for backward compatibility. Canonical list: GET https://www.consulti.ai/api/v1/meta/email-statuses"),
|
|
101
106
|
excludeListId: z.string().optional().describe("UUID of a saved list owned by the API key holder — leads in this list will be excluded from results. Response includes both `total` (pre-exclusion) and `total_after_exclusion` (post) so the caller can verify exclusion fired."),
|
|
102
107
|
page: z.number().optional().describe("Page number (default: 1)"),
|
|
103
108
|
size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
|
|
@@ -121,8 +126,6 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
|
|
|
121
126
|
body.empMin = params.empMin;
|
|
122
127
|
if (params.empMax !== undefined)
|
|
123
128
|
body.empMax = params.empMax;
|
|
124
|
-
if (params.emailStatus)
|
|
125
|
-
body.emailStatus = params.emailStatus;
|
|
126
129
|
if (params.excludeListId)
|
|
127
130
|
body.excludeListId = params.excludeListId;
|
|
128
131
|
if (params.page !== undefined)
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "consulti-mcp",
|
|
3
|
-
"version": "2.0
|
|
4
|
-
"description": "Consulti.ai MCP server —
|
|
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.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"consulti-mcp": "dist/index.js"
|