consulti-mcp 2.6.0 → 2.6.1

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
@@ -70,9 +70,9 @@ Verify if an email address is valid and deliverable.
70
70
 
71
71
  ### verify_catchall
72
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`.
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`. A call usually answers within about 50 seconds and can run for up to 300, and the client's timeout is longer than that. A 503 `verifier_unavailable` means no verdict in time, with the credits refunded; a 500 `refund_unconfirmed` means the refund could not be confirmed, so check credits before retrying.
74
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).
75
+ **Cost:** 5 verification credits per call (charged on success, including cache hits; refunded on a 503 `verifier_unavailable`). A 500 is not always refunded: `refund_unconfirmed` means the refund could not be confirmed, and a 500 raised after the verdict was reached can stay billed, so check credits before retrying any 500. Requires a plan with catch-all verification enabled (Pro or higher).
76
76
 
77
77
  | Input | Type | Description |
78
78
  | ------- | ------ | ------------------------------------------------- |
package/dist/server.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare const VERSION = "2.6.0";
2
+ export declare const VERSION = "2.6.1";
3
3
  export type ConsultiMcpApiPost = (path: string, body: Record<string, unknown>) => Promise<string>;
4
4
  export type ConsultiMcpApiGet = (path: string) => Promise<string>;
5
5
  /**
package/dist/server.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { z } from "zod";
3
3
  import { handleSearchB2bLeads, searchB2bLeadsInputObjectSchema } from "./leads-search.js";
4
- export const VERSION = "2.6.0";
4
+ export const VERSION = "2.6.1";
5
5
  /**
6
6
  * Build the Consulti MCP server with every stable tool registered.
7
7
  * Import-safe: does not connect a transport, read env, or start stdio.
@@ -15,7 +15,7 @@ export function createConsultiMcpServer(options) {
15
15
  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 }) => ({
16
16
  content: [{ type: "text", text: await apiPost("/verify", { email }) }],
17
17
  }));
18
- 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 }) => ({
18
+ 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). A call usually answers within about 50 seconds and can run for up to 300; this client waits longer than that. A 503 verifier_unavailable means no verdict in time and the credits were refunded; a 500 refund_unconfirmed means the refund could not be confirmed, so check get_credits before retrying.", { email: z.string().describe("The email address on a catch-all domain to resolve") }, async ({ email }) => ({
19
19
  content: [{ type: "text", text: await apiPost("/verify/catchall", { email }) }],
20
20
  }));
21
21
  server.tool("enrich_lead", "Enrich a lead's full profile using their email address, including company-level funding, traffic, HQ, followers, and specialties when the lead is linked to a company. 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 }) => ({
@@ -29,7 +29,7 @@ export function createConsultiMcpServer(options) {
29
29
  inputSchema: searchB2bLeadsInputObjectSchema,
30
30
  }, async (params) => handleSearchB2bLeads(params, apiPost));
31
31
  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.", {
32
- q: z.string().optional().describe("Free text search across username and bio"),
32
+ q: z.string().optional().describe("Case-insensitive text match on username or full name"),
33
33
  bioKeywords: z.array(z.string()).optional().describe("Keywords to search for in profile bios"),
34
34
  excludeKeywords: z.array(z.string()).optional().describe("Exclude profiles whose bio matches any of these keywords"),
35
35
  excludeAdultContent: z.boolean().optional().describe("Exclude profiles with adult/sexual content terms in their bio"),
@@ -1,8 +1,9 @@
1
1
  /**
2
2
  * Per-route client timeouts, keyed by path template. The client must outlast the route's
3
3
  * maxDuration, otherwise it aborts while the server is still working and bills, and a
4
- * retry then charges again. /leads/search runs for up to 120 s; a route that exports no
5
- * maxDuration runs under Vercel's 300 s default.
4
+ * retry then charges again. /leads/search runs for up to 120 s; /verify/catchall answers
5
+ * within about 50 s and caps at 300 s; a route that exports no maxDuration runs under
6
+ * Vercel's 300 s default.
6
7
  */
7
8
  export declare const TOOL_TIMEOUT_MS: Record<string, number>;
8
9
  export declare const DEFAULT_TIMEOUT_MS = 310000;
package/dist/transport.js CHANGED
@@ -2,8 +2,9 @@
2
2
  /**
3
3
  * Per-route client timeouts, keyed by path template. The client must outlast the route's
4
4
  * maxDuration, otherwise it aborts while the server is still working and bills, and a
5
- * retry then charges again. /leads/search runs for up to 120 s; a route that exports no
6
- * maxDuration runs under Vercel's 300 s default.
5
+ * retry then charges again. /leads/search runs for up to 120 s; /verify/catchall answers
6
+ * within about 50 s and caps at 300 s; a route that exports no maxDuration runs under
7
+ * Vercel's 300 s default.
7
8
  */
8
9
  export const TOOL_TIMEOUT_MS = {
9
10
  "/leads/search": 130_000,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "consulti-mcp",
3
- "version": "2.6.0",
3
+ "version": "2.6.1",
4
4
  "description": "Consulti.ai MCP server — 14 stable tools for email verification (incl. catch-all mailbox resolution), B2B lead search/enrichment, LinkedIn-URL enrichment, Instagram profile search, list management, inbox placement tests, 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": {