MCP server · in your IDE
The Model Context Protocol lets your agent call external tools, read live resources, and run reusable prompts.@cognilead/mcp-serverships sixteen tools — four keyless, twelve gated — plus four Resources and three Prompts. Draft a pitch, score the fit, check a domain’s deliverability with no key; hand it a key and the outbound pipeline plus read-only inspection light up.
$ npx -y @cognilead/mcp-server > 16 tools · 4 resources · 3 prompts > draft_pitch free > score_signal free > check_deliverability free > health free > ingest_lead gated > run_campaign soon > suppress gated > create_topup_link gated > generate_seo_content gated > list_leads gated > list_sends gated > list_suppressions gated > get_billing_usage gated > get_subscription gated > list_webhooks gated > list_api_keys gated > listening on stdio…
Four tools answer with no key. Hand it a key and twelve more — plus live resources — light up.
Sixteen tools
The keyless tools are top-of-funnel — draft, score, check deliverability, ping health, no key required. The gated tools touch the real pipeline (ingest, suppress, generate, top up credit) and read it back (leads, sends, suppressions, billing, subscription, webhooks, keys). run_campaign is registered but its endpoint is not live yet — it returns an “unavailable” error today.
cognilead.draft_pitchfreeDraft a cold-outbound pitch from a public signal (job post, GitHub repo, HN comment). Jurisdiction-aware routing — each recipient is processed in its own region. Returns subject, body, and a technical_hook_verified flag.
cognilead.score_signalfreeRate a JSON signal for fit against a target product (0–100, deterministic — no LLM call). Returns fit_score, reasoning, and a pitch | enrich | skip recommendation. Top-of-funnel filtering before you commit a draft.
cognilead.check_deliverabilityfreeCheck any domain’s SPF and DMARC records and grade them with prioritized findings. Pure local DNS — confirm a domain can land in the inbox before you send.
cognilead.healthfreePing the CogniLead API for reachability before you configure a key. Public read-only check — no key required.
cognilead.ingest_leadgatedRegister a lead in the pipeline. Runs the intersect stage (suppression check, dedup) so the lead enters clean and returns the persisted row.
cognilead.run_campaignsoonKick off a campaign by id, optionally restricted to a set of lead ids. NOTE: campaign endpoints are not live yet — this currently returns a structured “unavailable” error. Registered so the surface is stable ahead of launch.
cognilead.suppressgatedAdd an email or domain to the suppression list with a reason. Filtered by the intersect stage on every future lead — the backbone of one-click unsubscribe.
cognilead.create_topup_linkgatedStart a Stripe Checkout to top up an end-customer’s prepaid credit balance. Returns a { url } for the human to pay; on payment the customer’s credit ledger is credited.
cognilead.generate_seo_contentgatedGenerate SEO content via phi-cloud — a full blog/landing page (title, slug, meta, headings, Markdown body, keywords, internal-link ideas), or a prioritized on-page audit of existing copy.
cognilead.list_leadsgatedList leads in your pipeline, cursor-paginated. Returns { leads, next_cursor }.
cognilead.list_sendsgatedList the send/dispatch history for one lead (lead_id required), cursor-paginated. Returns { sends, next_cursor } with delivery state.
cognilead.list_suppressionsgatedList the suppressed emails and domains on your account, cursor-paginated.
cognilead.get_billing_usagegatedGet current billing-period usage — sends consumed, quota remaining, and the rest of the meter.
cognilead.get_subscriptiongatedGet your subscription details — plan, status, and limits.
cognilead.list_webhooksgatedList the webhook endpoints configured on your account.
cognilead.list_api_keysgatedList API key metadata — id, prefix, label, timestamps. Hashes and secrets are stripped server-side.
Not just tools
MCP is more than function calls. CogniLead exposes read-only Resources your agent can pull into context, and reusable Prompts that encode the deliverability playbooks — so the model produces on-brand, compliance-aware output and knows which tool to call next.
cognilead://docsDocs index — no keycognilead://sends/recentRecent sends + delivery statecognilead://suppressionsCurrent suppression listcognilead://pool/mailboxesReserved warmed mailboxescold-outbound-sequenceCompliant 3-step sequence for a product + ICPdeliverability-triageDiagnose why a domain lands in spamwarmup-planWeek-by-week ramp for a new sending domainInstall
The binary is cognilead-mcp, distributed via npm, run on demand with npx over stdio (no hosted/remote endpoint — the IDE launches it as a child process). Drop the JSON into your IDE’s MCP config file and restart. Omit the API key to run in free-tier mode — only the four keyless tools will be callable; gated tools return a structured auth error with an inline signup URL.
{
"mcpServers": {
"cognilead": {
"command": "npx",
"args": ["-y", "@cognilead/mcp-server"],
"env": {
"COGNILEAD_API_KEY": "pk_live_..."
}
}
}
}{
"mcpServers": {
"cognilead": {
"command": "npx",
"args": ["-y", "@cognilead/mcp-server"],
"env": {
"COGNILEAD_API_KEY": "pk_live_..."
}
}
}
}{
"mcpServers": {
"cognilead": {
"command": "npx",
"args": ["-y", "@cognilead/mcp-server"],
"env": {
"COGNILEAD_API_KEY": "pk_live_..."
}
}
}
}npm install -g @cognilead/mcp-server # or run on demand npx -y @cognilead/mcp-server
Free vs paid
The four keyless tools never expire and never require a key — they exist so an agent can learn the surface area before you commit. The twelve gated tools are the upsell: they touch real sender domains and lead pipelines, and read your account state back.
Install the MCP server, draft a pitch, score the fit, check a domain’s deliverability — all without an API key. When the agent starts asking to touch the real pipeline, hand it a key and the twelve gated tools, resources, and prompts light up.