MCP setup

Install

Clone the DialDozer repository, then run the zero-dependency Node server directly:

git clone https://github.com/brahimhamichan/dial-dozer.git
cd dial-dozer
node tools/dialdozer/bin/dialdozer-mcp.mjs

Configure an MCP client

Pass the API key through the process environment, never through chat context.

{
  "mcpServers": {
    "dialdozer": {
      "command": "node",
      "args": ["/absolute/path/to/dial-dozer/tools/dialdozer/bin/dialdozer-mcp.mjs"],
      "env": {
        "DIALDOZER_API_KEY": "${DIALDOZER_API_KEY}",
        "DIALDOZER_BASE_URL": "https://app.dialdozer.com"
      }
    }
  }
}

Set the secret in the parent process:

export DIALDOZER_API_KEY='ddz_live_replace_me'

The MCP server uses newline-delimited JSON-RPC over stdio. It writes protocol messages only to stdout and can complete initialize and tools/list before API credentials are available.

Verify

Ask the client to list tools, then call dialdozer_get_lead with a known test lead. A wrong_scope response means the transport works but the key needs leads:read.