consulti-mcp 2.1.0 → 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 +34 -6
- package/dist/index.js +5 -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.
|
|
@@ -100,7 +130,7 @@ Enrich a person by their LinkedIn profile URL → a verified work email plus the
|
|
|
100
130
|
|
|
101
131
|
### search_b2b_leads
|
|
102
132
|
|
|
103
|
-
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.
|
|
104
134
|
|
|
105
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.
|
|
106
136
|
|
|
@@ -115,7 +145,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
115
145
|
| `company` | string | Company name to search for |
|
|
116
146
|
| `empMin` | number | Minimum employee count |
|
|
117
147
|
| `empMax` | number | Maximum employee count |
|
|
118
|
-
| `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` |
|
|
119
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. |
|
|
120
149
|
| `page` | number | Page number (default: 1) |
|
|
121
150
|
| `size` | number | Results per page (default: 25, max: 100) |
|
|
@@ -132,7 +161,6 @@ Search a database of 500M+ B2B leads with filters like job title, industry, loca
|
|
|
132
161
|
"countries": ["United States"],
|
|
133
162
|
"empMin": 50,
|
|
134
163
|
"empMax": 500,
|
|
135
|
-
"emailStatus": "verified",
|
|
136
164
|
"excludeListId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
137
165
|
"size": 25
|
|
138
166
|
}
|
|
@@ -220,7 +248,7 @@ Print the installed version:
|
|
|
220
248
|
|
|
221
249
|
```bash
|
|
222
250
|
npx -y consulti-mcp --version
|
|
223
|
-
# → 2.
|
|
251
|
+
# → 2.2.0
|
|
224
252
|
```
|
|
225
253
|
|
|
226
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,13 +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
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 }) => ({
|
|
91
94
|
content: [{ type: "text", text: await apiPost("/enrich/linkedin", { linkedin_url }) }],
|
|
92
95
|
}));
|
|
93
|
-
server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. 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.", {
|
|
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.", {
|
|
94
97
|
q: z.string().optional().describe("Free text search across name, title, company, and industry"),
|
|
95
98
|
titles: z.array(z.string()).optional().describe("Job titles to filter by (e.g. [\"CEO\", \"VP Marketing\"])"),
|
|
96
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,7 +103,6 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
|
|
|
100
103
|
company: z.string().optional().describe("Company name to search for"),
|
|
101
104
|
empMin: z.number().optional().describe("Minimum employee count"),
|
|
102
105
|
empMax: z.number().optional().describe("Maximum employee count"),
|
|
103
|
-
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"),
|
|
104
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."),
|
|
105
107
|
page: z.number().optional().describe("Page number (default: 1)"),
|
|
106
108
|
size: z.number().optional().describe("Results per page (default: 25, max: 100)"),
|
|
@@ -124,8 +126,6 @@ server.tool("search_b2b_leads", "Search a database of 500M+ B2B leads with filte
|
|
|
124
126
|
body.empMin = params.empMin;
|
|
125
127
|
if (params.empMax !== undefined)
|
|
126
128
|
body.empMax = params.empMax;
|
|
127
|
-
if (params.emailStatus)
|
|
128
|
-
body.emailStatus = params.emailStatus;
|
|
129
129
|
if (params.excludeListId)
|
|
130
130
|
body.excludeListId = params.excludeListId;
|
|
131
131
|
if (params.page !== undefined)
|
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.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"
|