@cognilead/mcp-server

@cognilead/mcp-server

Model Context Protocol server for CogniLead — the managed cold-email deliverability engine for EU/technical B2B (plus AI content scaffolding). Exposes five tools to Cursor, Claude Desktop, Windsurf, and any MCP-capable client so you can draft outbound copy and run campaigns without leaving your IDE. All generation runs on phi-cloud as the LLM provider.

Two tools are free (no API key, daily-capped). Three are gated behind a CogniLead API key — when the key is absent, the tool returns an inline signup URL so you can fix it in seconds.

Install

npm install -g @cognilead/mcp-server
# or run on demand without installing
npx -y @cognilead/mcp-server

The binary is cognilead-mcp and speaks the MCP stdio transport.

Configure your IDE

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json per-project):

{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "COGNILEAD_API_KEY": "pk_live_..."
      }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "COGNILEAD_API_KEY": "pk_live_..."
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "cognilead": {
      "command": "npx",
      "args": ["-y", "@cognilead/mcp-server"],
      "env": {
        "COGNILEAD_API_KEY": "pk_live_..."
      }
    }
  }
}

Omit COGNILEAD_API_KEY to run in free-tier mode (only draft_pitch and score_signal are callable; the three gated tools return a 401 with an inline upgrade URL).

Tools

Tool	Tier	Daily cap	What it does
cognilead.draft_pitch	free	20/day	Draft a short, personalised outbound pitch from the insight/context you feed it (the product, topic, and target account).
cognilead.score_signal	free	50/day	Score a supplied insight/context for fit against a target product (0-100, deterministic).
cognilead.ingest_lead	gated	—	Register a (customer-supplied) lead in the outbound pipeline.
cognilead.run_campaign	gated	—	Kick off an email campaign by id, optionally restricted to a set of leads.
cognilead.suppress	gated	—	Add an email or domain to the suppression list (honours one-click RFC 8058 unsubscribe).

Note: MarketPrior-fed targeting tools are roadmap, not live. Today you supply leads/context yourself; CogniLead runs the deliverability.

Free-tier quotas reset at UTC midnight and persist between IDE restarts in ~/.cognilead/quota.json.

Environment

Var	Default	Purpose
COGNILEAD_API_KEY	unset	Bearer token for gated tools
COGNILEAD_API_URL	https://api.cognilead.ai	Override for self-hosted
COGNILEAD_SIGNUP_URL	https://cognilead.ai/signup?via=mcp	Upgrade-hint URL
COGNILEAD_QUOTA_DIR	~/.cognilead	Free-tier quota state directory
COGNILEAD_MCP_HTTP_PORT	8787	Only used by the hosted-MCP HTTP variant

Get a key

Sign up — the free tier ships with 100 outbound sends per month plus capped AI content scaffolding. Paid plans add warmed sender pools, the reputation circuit-breaker, and reply/bounce handling. (MarketPrior-fed targeting is roadmap, not yet available.)

Local development

cd packages/mcp-server
npm install
npm run dev       # tsx src/index.ts (stdio)
npm run build     # tsc → dist/
npm run start     # node dist/index.js
npm run start:http  # node dist/http.js — hosted-MCP HTTP variant

To test the binary doesn't crash on startup:

node packages/mcp-server/dist/index.js < /dev/null

It should exit cleanly when stdin closes.

License

MIT