MCP (Claude, ChatGPT, etc)

The WhiteWhale MCP connects Claude directly to your WhiteWhale account. Once it’s set up, you can ask Claude questions about your accounts and signals in plain English and get real answers from your live data.

MCP stands for Model Context Protocol. It’s a way to give Claude access to tools and data outside of the conversation. You don’t need to understand how it works — just follow the setup steps below and Claude will handle the rest.

What you can ask Claude

Once connected, ask Claude anything about your WhiteWhale data:

“Which accounts should I reach out to today?”
“Add these 20 companies to my list: [paste domains]”
“What signals am I tracking and are they configured well?”
“How many account credits do I have left?”
“Find me new target accounts that match my ICP” Claude will pull your live WhiteWhale data and respond in plain English — no dashboards, no exports, no copy-pasting.

Prerequisites

You need a WhiteWhale account with an API key.

Get your API key

In WhiteWhale, go to Settings → API & Webhooks → click Generate API Key. Copy the key — you’ll need it in the next step. Your user is the email address you use to log into WhiteWhale.

Setup: Claude Connector (Easiest)

This is the fastest way to connect — no downloads, no config files, no terminal.

Open Claude and go to Connectors

In Claude, go to Settings → Connectors → Custom Connectors.

Add the WhiteWhale connector

Paste this URL: https://app.getwhitewhale.com/mcp

Start a new chat and give Claude your credentials

Open a new chat and tell Claude who you are and what you want. Include your API key and email directly in the message — Claude needs these to connect to your account. Example prompt:

Please pull my best 5 accounts from WhiteWhale for [YOUR COMPANY].
Here is my public API key (This is ok to share): [PASTE YOUR API KEY]
And my email: [YOUR WHITEWHALE LOGIN EMAIL]

Claude will use these to connect and pull your live data. You only need to provide credentials once per conversation. If you start a new conversation you may need to give claude the credentials again, keep that prompt handy or save it as a skill.

You're connected

Claude will respond with your actual WhiteWhale data. From here, keep asking questions in plain English — “Show me signals on [company]”, “What’s my score on [account]”, “Add these domains to my list.”

Setup: MCP (Advanced)

If you use the Claude Code or ChatGPT, you can connect via a config file instead. Requires: Node.js 18 or later

Find your Claude Desktop config file

Open this file in any text editor:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn’t exist yet, create it.

Add WhiteWhale to the config

Paste the following into the file, replacing the placeholder values with your actual API key and email:

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

Restart Claude Desktop

Fully quit and reopen Claude Desktop. You should see whitewhale appear in the tools list.

Setup: Claude Code

If you use Claude Code (the command line version), run this command in your terminal:

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

Built-in workflows

Claude comes with a set of pre-built WhiteWhale workflows you can trigger with a single prompt:

Ask Claude	What it does
”Show me my daily priorities”	Your highest-scoring accounts ranked by signal activity
”Add accounts”	Validates and uploads a list of companies
”Review my signals”	Checks your current signal setup and suggests improvements
”Find new accounts”	Runs Account Suggestions to discover new target accounts
”Give me an account overview”	Full summary of your WhiteWhale setup and health

Troubleshooting

WhiteWhale isn't showing up in Claude's tools list

Fully quit and restart Claude Desktop or Claude Code after editing the config file. A partial close won’t pick up the changes.

Authentication failed (401 error)

Check that your API key has no extra spaces or line breaks when you pasted it. Make sure BIRDDOG_USER is the exact email address you use to log into WhiteWhale.

Error: Missing credentials

Make sure BIRDDOG_API_KEY and BIRDDOG_USER are inside the "env" block in your config file, not in the "args" section.

Node version error

Run node --version in your terminal. If it shows lower than v18, download the latest version of Node.js.

How to update to the latest version

Run npx --yes @getbirddog/mcp@latest in your terminal.

Optional: faster startup

By default, the MCP downloads fresh each time Claude starts. To make it launch faster, install it globally:

npm install -g @getbirddog/mcp

Then change "command": "npx" to "command": "birddog-mcp" and remove the "args" line from your config.

Keep your API key secure. Never paste it into a shared document or commit your config file to version control. Add claude_desktop_config.json and .claude/mcp.json to your .gitignore.

GitHub: github.com/BirdDog-Intel/WhiteWhale-MCP

API Reference

Access WhiteWhale data programmatically without Claude.

Using the Why Now Summary

Understand the account data Claude is pulling for you.

​What you can ask Claude

​Prerequisites

​Get your API key

​Setup: Claude Connector (Easiest)

​Setup: MCP (Advanced)

​Setup: Claude Code

​Built-in workflows

​Troubleshooting

​Optional: faster startup

​Related

API Reference

Using the Why Now Summary

What you can ask Claude

Prerequisites

Get your API key

Setup: Claude Connector (Easiest)

Setup: MCP (Advanced)

Setup: Claude Code

Built-in workflows

Troubleshooting

Optional: faster startup

Related