BirdDog MCP Server

Connect Claude to BirdDog — your sales signal intelligence platform. Ask Claude which accounts to prioritize, upload new targets, configure signals, and manage your ICP — all in natural language.

Quick Start

1. Get your credentials

• Log into scout.getbirddog.ai → Settings → Setup Webhook - Generate API Key
• Your API key is on that page. Your user is your login email.

2. Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "birddog": {
      "command": "npx",
      "args": ["-y", "@getbirddog/mcp"],
      "env": {
        "BIRDDOG_API_KEY": "your-api-key-here",
        "BIRDDOG_USER": "you@yourcompany.com"
      }
    }
  }
}

3. Restart Claude Desktop — you'll see "birddog" in the tools list.

4. Ask Claude: "Show me my hottest BirdDog accounts" — Claude will take it from there.

What You Can Ask Claude

Once connected, Claude understands BirdDog and can guide you through anything:

"Which accounts should I reach out to today?" "Add these 20 companies to my ICP: [list]" "What signals am I tracking and are they configured well?" "How many credits do I have left?" "Discover new target accounts using AI" "Set up a webhook to notify Slack when accounts go hot"

Built-in Workflows (Prompt Templates)

These appear as clickable starters in Claude's UI:

| Prompt | What It Does | |--------|-------------| | Daily Prioritization | Shows your hottest accounts ranked by signal score | | Add Accounts | Validates and uploads a list of companies to track | | Configure Signals | Reviews your current signal setup and suggests improvements | | Discover Accounts | Runs Farsight AI to find new target accounts | | Account Overview | Full summary of your BirdDog setup and health |

Setup Options

Claude Code

claude mcp add birddog \
  -e BIRDDOG_API_KEY=your-key \
  -e BIRDDOG_USER=you@company.com \
  -- npx -y @getbirddog/mcp

Or add to .claude/mcp.json in your project:

{
  "mcpServers": {
    "birddog": {
      "command": "npx",
      "args": ["-y", "@getbirddog/mcp"],
      "env": {
        "BIRDDOG_API_KEY": "your-api-key-here",
        "BIRDDOG_USER": "you@yourcompany.com"
      }
    }
  }
}

Faster Startup (Optional)

Install globally to avoid the npx download on every start:

npm install -g @getbirddog/mcp

Then use "command": "birddog-mcp" (no args needed) in your config.

Alternative: CLI Flags

npx @getbirddog/mcp --api-key YOUR_KEY --user you@company.com

Prerequisites

• Node.js 18 or later — download here
• A BirdDog account with an API key

Key Concepts

ICP (Ideal Customer Profile) — A group of accounts you're tracking, along with the signals that matter for that segment. You can have multiple ICPs (e.g., by territory, product, or team).

Signals — Questions BirdDog evaluates for each account (e.g., "Is this company hiring?", "Did they raise funding?"). Each signal has a weight:

• 6.0 High — strong buying intent, heavily influences score
• 1.0 Normal — standard weight
• 0.1 Low — soft signal, minor influence
• 0.0 Disqualify — negative signal, lowers the score

Signal Score — Each account gets a 0–100 score. Above 60 = prioritize for outreach. Ask Claude get_accounts sorted by scaled_score to see your hottest accounts.

Farsight — BirdDog's AI discovery engine. Finds new companies that match your ICP profile. Rate-limited to once per 2 hours per ICP.

Available Tools

| Tool | What It Does | |------|-------------| | get_user_data | Your ICPs, signals, credits, and account count — start here | | get_accounts | Tracked accounts ranked by signal activity score | | upload_accounts | Add new companies to track | | change_accounts_status | Activate, archive, or delete accounts | | normalize_accounts | Validate and clean URLs before bulk upload | | get_signal_templates | All available signal questions | | add_signals | Add a signal to your ICP with a custom weight | | delete_signal | Remove a signal from tracking | | get_icp_details | Full ICP config: signals, limits, Farsight settings | | add_icp | Create a new child ICP (territory, product line, etc.) | | run_farsight | Trigger AI account discovery (once per 2h per ICP) | | set_webhook | Connect BirdDog events to Slack, HubSpot, or any endpoint | | test_webhook | Verify your webhook is receiving events | | get_all_users | All users in your org (admin only) |

Troubleshooting

"Server not showing up in Claude" → Restart Claude Desktop / Claude Code after editing the config file.

"Authentication failed (401)" → Double-check your API key has no extra spaces or line breaks. Verify BIRDDOG_USER matches your login email exactly.

"Error: Missing credentials" → Make sure BIRDDOG_API_KEY and BIRDDOG_USER are in the "env" block of your config (not in args).

Node version error → Run node --version — you need v18+. Download here.

Force update to latest version → npx --yes @getbirddog/mcp@latest

Security

Treat your API key like a password. Never commit your config file to version control. Add claude_desktop_config.json and .claude/mcp.json to your .gitignore.

License

MIT

Note on LLM Authorship

This entire repo was written by an LLM. Use accordingly and with caution.