Skip to content

Repository files navigation

SalesBlink Cold Email Outreach Skill

GitHub release Claude Desktop one-click install GitHub stars Last commit Release downloads Website License: MIT

Run cold email sequences and sales outreach on autopilot via the SalesBlink API. Works with any AI agent — Claude, Claude Code, Claude Desktop, ChatGPT, OpenClaw, Cursor, Codex, Hermes, and more. Install it as an agent skill, or use the one-click .mcpb bundle for MCPB-compatible hosts.


Install in 30 seconds

1. Get your API key (or sign up)

Grab your key from run.salesblink.io/account/integration/api, or use the salesblink_signup tool to get the public sign-up link.

2. Install the skill

Recommended: let your agent install it (copy-paste prompt)

Paste this into your AI agent and it will set everything up for you:

Set up the SalesBlink Cold Email agent skill from https://github.com/open-salesblink/skill
for me. Read the README and SKILL.md in that repo, then install the skill in this
environment using the method that fits you best.

Ask me for my SalesBlink API key (from
https://run.salesblink.io/account/integration/api), or use the salesblink_signup
tool to get the sign-up link if I don't have an account yet. Configure the API key
as SALESBLINK_API_KEY. Verify the setup works, then help me launch my first cold
email sequence: ask what product I'm selling and who I'm targeting, create the
list, contacts, templates, and sequence, and walk me through launching it.

Or install manually

Any agent (npx)

npx skills add open-salesblink/skill

Claude Code

/plugin marketplace add https://github.com/open-salesblink/skill
/plugin install cold-email-salesblink

Hermes

hermes skills tap add open-salesblink/skill
hermes skills install cold-email-salesblink

OpenClaw / ClawHub

openclaw skills install cold-email-salesblink

3. Set your API key

export SALESBLINK_API_KEY="key-****"

4. Start working

  • "Create a cold email sequence for my SaaS product"
  • "Add these leads to a new list and launch a campaign"
  • "Check analytics for opens and replies from last week"
  • "Run an inbox placement test for my template"

What you can do

  • Cold email campaigns — build sequences, write templates, and launch outreach
  • Lead management — create lists, import contacts in bulk, move and update leads
  • Sender management — connect Gmail/Outlook via OAuth; SMTP/IMAP and bulk CSV through the SalesBlink web UI
  • Inbox & replies — read threads, reply to prospects, mark conversations
  • Analytics — track opens, clicks, replies, and sent events
  • Deliverability testing — run inbox placement tests across providers
  • Workspace & team management — users, roles, folders, and account config

Other platforms

Codex

codex plugin marketplace add https://github.com/open-salesblink/skill

Invoke by referencing the plugin namespace.

Cursor

git clone https://github.com/open-salesblink/skill.git

Load the plugin from the cloned directory in Cursor's plugin settings.

ChatGPT

ChatGPT connects via MCP — visit https://mcp.salesblink.io and add SalesBlink as an MCP connector, or use the .mcpb bundle below in an MCPB-compatible host.

MCP

Visit https://mcp.salesblink.io to connect via MCP.

Claude Desktop / MCP Bundle (.mcpb)

Download MCPB

⬇ Download cold-email-salesblink.mcpb — one-click install of this skill in MCPB-compatible hosts (e.g. Claude for macOS/Windows). Open the downloaded file and enter your SALESBLINK_API_KEY when prompted.

The bundle runs a local Node.js MCP server with hardened gateway tools plus the full bundled API reference. Source lives in mcpb/cold-email-salesblink/. To build it yourself instead of downloading:

cd mcpb/cold-email-salesblink
npm install --omit=dev
npm test                            # protocol smoke test (no API key needed)
npx @anthropic-ai/mcpb pack .       # produces cold-email-salesblink.mcpb

See mcpb/cold-email-salesblink/README.md for tools, configuration, and security details.

Note: All platforms above require the same SALESBLINK_API_KEY environment variable shown in Step 3.


API Quick Reference

Base URL

https://run.salesblink.io/api/public/v1.0.0

Authentication Pass your API key in the Authorization header with no "Bearer" prefix:

Authorization: key-****

Pagination

  • Most list endpoints: limit (max 100) and skip
  • Activity endpoints (/sent, /opens, /clicks, /replies): per_page (max 100) and page (1-indexed)

Always paginate — never assume a single request returns all data.

Error Handling

Status Meaning Action
200 Success Check success field
400 Bad request Re-check payload structure against the reference file
401 Unauthorized Verify API key
403 Forbidden Insufficient permissions (role too low)
404 Not found Verify the ID / endpoint
409 Conflict Resource already exists or connection failed
429 Rate limited Wait 60s, then retry
500 Server error Retry once after 10s

Quick Start: End-to-End Campaign

See skills/cold-email-salesblink/references/workflows.md for full examples. High-level flow:

  1. Create a listPOST /lists
  2. Add contactsPOST /contacts (batch up to 500, snake_case fields)
  3. Create templatesPOST /templates (merge vars like {{first_name}})
  4. Fetch sendersGET /senders
  5. Create sequencePOST /sequences (steps: email → delay → email …)
  6. LaunchPATCH /sequences/:id with paused: false & launchTimingMode: "now"

Evaluations

The evals/evals.json file contains test scenarios covering list creation, bulk contact import, sequence creation, large CSV ingestion, inbox replies with CC, and paginated activity tracking.


Compatibility

  • Requires network access to run.salesblink.io
  • Supports any HTTP client (curl, Node.js fetch, Python requests, PowerShell, etc.)

License

MIT — © FUTUREBLINK Inc. See LICENSE.

About

Agent Skill so that your AI Assistant can help you setup cold email sequences & more.

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages