MCP server · in your IDE

CogniLead inside
Cursor, Claude Desktop, and Windsurf.

The Model Context Protocol lets your agent call external tools.@cognilead/mcp-servergives it six — two free, four gated. Draft a cold pitch from a scraped signal, score the fit, register a lead, kick off a campaign, render an evidence pack. Every gated call is anchored to Chainlog from the first request, so the audit trail starts before you’ve even shipped to production.

6MCP tools2 free, 4 gated
70/dayfree quota20 drafts + 50 scores
0config to startworks without an API key
The six tools

Two free forever. Four behind an API key.

The free tools are top-of-funnel — draft and score, no key required, daily quotas only. The gated tools touch the real pipeline: every call writes to your Chainlog shard and counts against your send budget.

cognilead.draft_pitchfree

Draft a three-sentence engineer-to-engineer cold pitch from a public signal — a job post URL, a repo, an HN thread. EU/CH jurisdiction routing through PHI Gateway.

20 / day
cognilead.score_signalfree

Rate a scraped JSON signal for fit against a target product (0–100, deterministic). Top-of-funnel filtering before you commit a draft call.

50 / day
cognilead.ingest_leadgated

Register a lead in the pipeline. Runs the intersect step (suppression → dedup → Chainlog anchor) so the lead enters with an immutable timestamp.

counts against send budget
cognilead.run_campaigngated

Kick off a campaign by id, optionally restricted to a list of lead ids. Resend Automations drives the sequence; AgentGate gates every step.

per-send billing
cognilead.suppressgated

Add an email or domain to the suppression list. Honored across all sender pools in under 60 seconds. Writes a Chainlog event.

free, gated tier only
cognilead.evidence_exportgated · Growth+

Export the Chainlog-backed GDPR evidence pack — JSON for free on any paid tier, or render the 6-page A4 PDF and return a signed download URL.

$5 / lead · Growth+
Install

Three IDEs, one config block.

The binary is cognilead-mcp, distributed via npm, run on demand with npx. Drop the JSON into your IDE’s MCP config file and restart. Omit the API key to run in free-tier mode — only the two free tools will be callable; gated tools return a 401 with an inline signup URL.

Cursor

json
~/.cursor/mcp.json
{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "PITCHFORGE_API_KEY": "pf_live_..."
      }
    }
  }
}

Claude Desktop

json
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "PITCHFORGE_API_KEY": "pf_live_..."
      }
    }
  }
}

Windsurf

json
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "PITCHFORGE_API_KEY": "pf_live_..."
      }
    }
  }
}
One-line install
npm install -g @cognilead/mcp-server
# or run on demand
npx -y @cognilead/mcp-server
Read the spec
Free vs paid

Free gets you the wow. Paid gets you the pipeline.

The free tools never expire and never require a key — they exist so an agent can learn the surface area before you commit. The gated tools are the upsell: they touch real sender domains, real Chainlog events, real evidence packs.

Free tier
no API key
$0 forever
  • cognilead.draft_pitch — 20 calls / day
  • cognilead.score_signal — 50 calls / day
  • EU/CH jurisdiction routing on draft_pitch
  • Local quota persistence in ~/.cognilead/quota.json
  • Resets at UTC midnight
  • No ingest_lead, no run_campaign, no evidence_export
  • No suppression writes (read-only state)
Paid tier
API key required
From $49 / month
  • All four gated tools unlocked
  • cognilead.ingest_lead — intersect + Chainlog anchor
  • cognilead.run_campaign — Resend Automations, AgentGate-checked
  • cognilead.suppress — 60-second propagation
  • cognilead.evidence_export — JSON or signed PDF (Growth+)
  • Per-tenant Chainlog shard from the first call
Get an API key →
From install to first call

Two free tools today. The full pipeline when you’re ready.

Install the MCP server, draft a pitch from a job post, score a scraped signal — all without an API key. When the agent starts asking to run real campaigns, hand it a key and the gated tools light up.