Signals MCP Server

MCP server for the Signals lead intelligence API — gives AI agents tools to discover leads, manage subscriptions, and automate sales workflows.

---

Quick Setup

Claude Desktop

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

{
  "mcpServers": {
    "signals": {
      "command": "npx",
      "args": ["-y", "signals-sortlist-mcp"],
      "env": {
        "SIGNALS_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "signals": {
      "command": "npx",
      "args": ["-y", "signals-sortlist-mcp"],
      "env": {
        "SIGNALS_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add signals -- npx -y signals-sortlist-mcp -e SIGNALS_API_KEY=your_api_key

Get your API key from Settings > API Keys in your Signals dashboard.

For AI Agents

Install the Signals skill for your AI agent (Cursor, Claude Code, OpenClaw, etc.):

npx skills add sortlist/signals-cli

This installs a SKILL.md that gives your agent full knowledge of the CLI commands, patterns, and workflows.

---

Tools

The server exposes 19 tools covering the full Signals API:

Signals (catalog)

Tool	Description
list_signals	List all available signal types
get_signal	Get details of a specific signal by slug

Businesses

Tool	Description
list_businesses	List all businesses in your team
get_business	Get a business with its Ideal Customer Profile
create_business	Create a business (auto-analyze from URL or manual)
update_business	Update a business and/or its ICP

Subscriptions

Tool	Description
list_subscriptions	List subscriptions for a business
get_subscription	Get subscription details and stats
create_subscription	Subscribe to a signal for a business
update_subscription	Update subscription name or config
pause_subscription	Pause lead collection
resume_subscription	Resume a paused subscription
delete_subscription	Delete a subscription permanently

Leads

Tool	Description
list_leads	List leads for a business (paginated)
get_lead	Get full lead details
delete_lead	Delete a lead

Webhooks

Tool	Description
list_webhooks	List webhook endpoints
create_webhook	Register a webhook URL
delete_webhook	Remove a webhook endpoint

---

Environment Variables

Variable	Required	Description
SIGNALS_API_KEY	Yes	Your Signals API key
SIGNALS_API_URL	No	Override the API base URL (defaults to https://api.meetsignals.ai)

---

Development

git clone https://github.com/sortlist/signals-mcp.git
cd signals-mcp
npm install
npm run dev    # Watch mode
npm run build  # Production build

Project Structure

src/
  index.ts          # MCP server entry point (stdio transport)
  api.ts            # SignalsAPI HTTP client
  tools/
    signals.ts      # list_signals, get_signal
    businesses.ts   # Business CRUD + ICP management
    subscriptions.ts # Subscription lifecycle
    leads.ts        # Lead retrieval and deletion
    webhooks.ts     # Webhook management

---

Links

• Website: signals.sortlist.com
• API Docs: signals.sortlist.com/docs/api
• CLI: signals-sortlist-cli
• GitHub: sortlist/signals-mcp

---

License

MIT