consulti-mcp 2.0.0 → 2.1.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 +24 -3
- package/dist/index.js +7 -4
- 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 — **8 stable tools** to search 500M+ B2B leads, verify emails, enrich leads by email or LinkedIn URL, manage saved lists, and check credit balance.
|
|
7
7
|
|
|
8
|
-
> **Stable surface only.** Beta endpoints (LinkedIn lookup
|
|
8
|
+
> **Stable surface only.** Beta endpoints (LinkedIn cache-only lookup `find-by-linkedin`, 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
|
|
|
@@ -57,6 +57,8 @@ Add to `.cursor/mcp.json`:
|
|
|
57
57
|
|
|
58
58
|
Verify if an email address is valid and deliverable.
|
|
59
59
|
|
|
60
|
+
**Cost:** 1 verification credit per call.
|
|
61
|
+
|
|
60
62
|
| Input | Type | Description |
|
|
61
63
|
| ------- | ------ | --------------------------- |
|
|
62
64
|
| `email` | string | The email address to verify |
|
|
@@ -70,6 +72,8 @@ Verify if an email address is valid and deliverable.
|
|
|
70
72
|
|
|
71
73
|
Enrich a lead's full profile using their email address.
|
|
72
74
|
|
|
75
|
+
**Cost:** 1 lead credit — only deducted on a successful match; 404 responses are free.
|
|
76
|
+
|
|
73
77
|
| Input | Type | Description |
|
|
74
78
|
| ------- | ------ | --------------------------------------- |
|
|
75
79
|
| `email` | string | The email address of the lead to enrich |
|
|
@@ -79,10 +83,27 @@ Enrich a lead's full profile using their email address.
|
|
|
79
83
|
{ "email": "john@example.com" }
|
|
80
84
|
```
|
|
81
85
|
|
|
86
|
+
### enrich_linkedin
|
|
87
|
+
|
|
88
|
+
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.
|
|
89
|
+
|
|
90
|
+
**Cost:** 1 lead credit — charged only when an email is returned; phone-only or no-match responses are free.
|
|
91
|
+
|
|
92
|
+
| Input | Type | Description |
|
|
93
|
+
| -------------- | ------ | ------------------------------------------------------ |
|
|
94
|
+
| `linkedin_url` | string | The LinkedIn profile URL, e.g. https://linkedin.com/in/johndoe |
|
|
95
|
+
|
|
96
|
+
**Example:**
|
|
97
|
+
```json
|
|
98
|
+
{ "linkedin_url": "https://linkedin.com/in/johndoe" }
|
|
99
|
+
```
|
|
100
|
+
|
|
82
101
|
### search_b2b_leads
|
|
83
102
|
|
|
84
103
|
Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size. All inputs are optional.
|
|
85
104
|
|
|
105
|
+
**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
|
+
|
|
86
107
|
| Input | Type | Description |
|
|
87
108
|
| ---------------- | -------- | ------------------------------------------------------------------ |
|
|
88
109
|
| `q` | string | Free text search across name, title, company, and industry |
|
|
@@ -199,7 +220,7 @@ Print the installed version:
|
|
|
199
220
|
|
|
200
221
|
```bash
|
|
201
222
|
npx -y consulti-mcp --version
|
|
202
|
-
# → 2.
|
|
223
|
+
# → 2.1.0
|
|
203
224
|
```
|
|
204
225
|
|
|
205
226
|
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.1.0";
|
|
6
6
|
if (process.argv.includes("--version") || process.argv.includes("-v")) {
|
|
7
7
|
console.log(VERSION);
|
|
8
8
|
process.exit(0);
|
|
@@ -81,13 +81,16 @@ const server = new McpServer({
|
|
|
81
81
|
name: "consulti-mcp",
|
|
82
82
|
version: VERSION,
|
|
83
83
|
});
|
|
84
|
-
server.tool("verify_email", "Verify if an email address is valid and deliverable", { email: z.string().describe("The email address to verify") }, async ({ email }) => ({
|
|
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("enrich_lead", "Enrich a lead's full profile using their email address", { email: z.string().describe("The email address of the lead to enrich") }, async ({ email }) => ({
|
|
87
|
+
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
88
|
content: [{ type: "text", text: await apiPost("/leads/enrich", { email }) }],
|
|
89
89
|
}));
|
|
90
|
-
server.tool("
|
|
90
|
+
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
|
+
content: [{ type: "text", text: await apiPost("/enrich/linkedin", { linkedin_url }) }],
|
|
92
|
+
}));
|
|
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.", {
|
|
91
94
|
q: z.string().optional().describe("Free text search across name, title, company, and industry"),
|
|
92
95
|
titles: z.array(z.string()).optional().describe("Job titles to filter by (e.g. [\"CEO\", \"VP Marketing\"])"),
|
|
93
96
|
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"),
|
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.1.0",
|
|
4
|
+
"description": "Consulti.ai MCP server — 8 stable tools for email verification, 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"
|