@outreachbox/mcp

@outreachbox/mcp

Model Context Protocol server for OutreachBox. Run email outreach, prospecting, inbox triage and content campaigns from Claude, Cursor, ChatGPT, or any MCP-compatible client.

Quick start

Create an API key at outreachbox.com/apiEndpoints, then:

npx -y @outreachbox/mcp init --client claude --api-key pb_your_key

Restart your client. That is it.

Supported --client values: claude (Claude Desktop), claude-code, cursor, vscode.

Manual configuration

{
  "mcpServers": {
    "outreachbox": {
      "command": "npx",
      "args": ["-y", "@outreachbox/mcp"],
      "env": { "OUTREACHBOX_API_KEY": "pb_your_key" }
    }
  }
}

Skills

The package bundles a library of Agent Skills — step-by-step playbooks that teach the model how to combine the tools into real workflows, including when to ask before sending anything.

npx -y @outreachbox/mcp skills install --client claude
npx -y @outreachbox/mcp skills list

Skill	Use it for
outreachbox-getting-started	Connecting, scopes, troubleshooting
outreachbox-cold-email-campaign	Project, contacts, sequence, launch, monitor
outreachbox-prospect-research	Finding and qualifying prospects
outreachbox-inbox-triage	Classifying replies and drafting responses
outreachbox-content-engine	Topic research through to publishing
outreachbox-deliverability	Account health, verification, warmup
outreachbox-analytics-report	Campaign and team reporting

Commands

outreachbox-mcp                  Run the MCP server over stdio (default)
outreachbox-mcp init             Add OutreachBox to a client's MCP config
outreachbox-mcp skills install   Copy the skills into a client
outreachbox-mcp skills list      List the bundled skills
outreachbox-mcp doctor           Check connectivity and credentials

doctor is the first thing to run when something is wrong — it validates the key, names the organization it is bound to, and reports how many tools the key's scopes allow.

Configuration

Variable	Default	Purpose
OUTREACHBOX_API_KEY	—	API key. Required.
OUTREACHBOX_BASE_URL	https://api.outreachbox.com	API base URL
OUTREACHBOX_APP_URL	https://outreachbox.com	Used to build deeplinks in tool results
OUTREACHBOX_SOURCE	mcp	Attribution tag sent with each request
OUTREACHBOX_TIMEOUT_MS	30000	Per-request timeout

Scopes

The server only advertises tools the key is allowed to use, so a read-only key never exposes a tool that sends mail. Keys minted before scopes existed are treated as unrestricted. Check what a key can do with outreachbox-mcp doctor.

Programmatic use

The tool table is exported for hosts that want to serve it over their own transport:

import { TOOLS_LIST, executeTool, configure, authContext } from '@outreachbox/mcp';

configure({ baseUrl: 'https://api.outreachbox.com' });

const result = await authContext.run({ token: userToken }, () =>
  executeTool('contacts_list', { limit: 10 }),
);

@outreachbox/mcp/server exports createServer() if you want a preconfigured MCP Server instance.

License

MIT