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 CHANGED
@@ -3,9 +3,9 @@
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 — **7 stable tools** to search 500M+ B2B leads, verify emails, enrich leads, manage saved lists, and check credit balance.
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, 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
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.0.0
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.0.0";
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("search_b2b_leads", "Search a database of 500M+ B2B leads with filters like job title, industry, location, and company size", {
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.0.0",
4
- "description": "Consulti.ai MCP server — 7 stable tools for email verification, B2B lead search/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.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"