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.

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