Quickstart

Welcome to FullContact Support

Search our Knowledge Base or Contact Support.

Quickstart

On this page

This guide walks you through connecting the FullContact MCP Server to the most common AI clients. The setup is the same in spirit across every client: point the client at the MCP Server endpoint and supply your FullContact API key as a Bearer token.

If you don't yet have a key, generate one at docs.fullcontact.com/docs/generate-an-api-key before continuing.

📘 All clients require an API key
The MCP Server reuses your existing FullContact API key for authentication. There is no separate MCP credential to provision. Every example below assumes you have set the environment variable FULLCONTACT_API_KEY to your key, and we recommend using a secrets manager or .env rather than hard-coding the value.

The hosted MCP Server endpoint is:

https://api.fullcontact.com/v3/mcp

Claude Desktop

Claude Desktop loads MCP servers from claude_desktop_config.json. The server runs as a subprocess of the desktop app, so the config has to give it everything it needs to launch on its own — no shell environment, no PATH inheritance.

📘 Before you start
You need Node.js installed locally so that npx can fetch the mcp-remote bridge. Install Node from nodejs.org or via Homebrew (brew install node) before continuing. Confirm with which npx in a terminal — you'll need that absolute path in step 2.

1. Open the config file.

If the file doesn't exist, create it with {} as the contents. If it does exist, merge the mcpServers block below into it — don't overwrite any existing keys (e.g. preferences).

macOS Finder tip

The Library folder is hidden by default. In Finder, hold Option while clicking the Go menu — Library will appear in the list. Or press ⌘⇧G and paste ~/Library/Application Support/Claude.

2. Add the FullContact MCP Server entry.

{
  "mcpServers": {
    "fullcontact": {
      "command": "/opt/homebrew/bin/npx",
      "args": [\
        "-y",\
        "mcp-remote",\
        "https://api.fullcontact.com/v3/mcp",\
        "--header",\
        "Authorization: Bearer <your-fullcontact-api-key>"\
      ]
    }
  }
}

⚠️ Two gotchas worth calling out