# SalesBlink Cold Email Outreach Skill

[![GitHub release](https://img.shields.io/github/v/release/open-salesblink/skill)](https://github.com/open-salesblink/skill/releases)
[![Claude Desktop one-click install](https://img.shields.io/badge/Claude%20Desktop-one--click%20install-d97757)](https://github.com/open-salesblink/skill/releases/latest/download/cold-email-salesblink.mcpb)
[![GitHub stars](https://img.shields.io/github/stars/open-salesblink/skill)](https://github.com/open-salesblink/skill)
[![Last commit](https://img.shields.io/github/last-commit/open-salesblink/skill)](https://github.com/open-salesblink/skill/commits/main)
[![Release downloads](https://img.shields.io/github/downloads/open-salesblink/skill/total)](https://github.com/open-salesblink/skill/releases)
[![Website](https://img.shields.io/badge/website-salesblink.io-orange)](https://salesblink.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Run cold email sequences and sales outreach on autopilot via the [SalesBlink](https://salesblink.io) 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`](https://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:

```text
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)**

```bash
npx skills add open-salesblink/skill
```

**Claude Code**

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

**Hermes**

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

**OpenClaw / ClawHub**

```bash
openclaw skills install cold-email-salesblink
```

### 3. Set your API key

```bash
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; add SMTP/IMAP senders directly or in bulk from a CSV
- **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

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

Invoke by referencing the plugin namespace.

### Cursor

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

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

### Gemini CLI

```bash
gemini extensions install https://github.com/open-salesblink/skill
```

Gemini CLI prompts for your `SALESBLINK_API_KEY` and stores it in the system keychain.

### 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](https://img.shields.io/badge/download-latest_.mcpb-blue)](https://github.com/open-salesblink/skill/releases/latest/download/cold-email-salesblink.mcpb)

**[⬇ Download cold-email-salesblink.mcpb](https://github.com/open-salesblink/skill/releases/latest/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/`](mcpb/cold-email-salesblink/). To build it yourself instead of downloading:

```bash
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`](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`](skills/cold-email-salesblink/references/workflows.md) for full examples. High-level flow:

1. **Create a list** → `POST /lists`
2. **Add contacts** → `POST /contacts` (batch up to 500, snake_case fields)
3. **Create templates** → `POST /templates` (merge vars like `{{first_name}}`)
4. **Fetch senders** → `GET /senders`
5. **Create sequence** → `POST /sequences` (steps: email → delay → email …)
6. **Launch** → `PATCH /sequences/:id` with `paused: false` & `launchTimingMode: "now"`

---

## Evaluations

The [`evals/evals.json`](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](LICENSE).