MCP Server Overview
The FullContact Model Context Protocol (MCP) Server brings FullContact's identity and enrichment data directly into AI agents and AI-native developer tools. With a one-time configuration step, your existing FullContact API key powers an enrich_person tool that any MCP-compatible client — Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, Gemini(CLI only at this time) and others — can call as part of an agentic workflow.
The server is a thin, secure wrapper around FullContact's person.enrich API. It reuses the authentication, rate limits, and compliance controls that already govern your account, so you can adopt it without provisioning new credentials or signing new agreements.
What you can do with it
Drawing from our patented identity graph, the MCP Server empowers your AI agents to:
- Resolve a person from a single identifier. Pass an email, phone number, social profile, or name + postal address and receive a unified person profile.
- Enrich CRM and marketing workflows. Let an agent watch new signups, leads, or support tickets and append demographic, employment, and social data on the fly.
- Power conversational research. Ask your IDE assistant or chatbot, "Who is this person, and where do they work?" and get a structured answer grounded in FullContact data.
- Stay inside your existing controls. All calls are authenticated with your FullContact API key and counted against your normal rate limits and billing plan.
How it works
┌────────────────┐ MCP request ┌──────────────────────┐ HTTPS ┌────────────────────┐
│ AI agent / │ ────────────────▶ │ FullContact MCP │ ──────────▶ │ person.enrich API │
│ IDE / chatbot │ ◀──────────────── │ Server (wrapper) │ ◀────────── │ (api.fullcontact) │
└────────────────┘ structured └──────────────────────┘ identity └────────────────────┘
JSON result ▲ graph
│
Authorization: Bearer <FullContact API key>
- The AI client discovers the server's tool catalog and JSON Schema for
enrich_person. - When the agent decides to enrich a person, it sends an MCP request through the configured client.
- The MCP Server validates your API key, applies your account's rate limits, and forwards the request to
person.enrich. - The response is normalized into a compact, agent-friendly JSON payload and returned to the client.
NoteThe MCP Server does not store identity data. Inputs and responses pass through in-memory and are never written to disk or shared across customers. See Authentication for details on credential handling.
Available tools
| Tool | Purpose | Underlying API |
|---|---|---|
enrich_person | Resolve and enrich a person from email, phone, social, or name + location. | POST /v3/person.enrich |
Additional tools (company enrichment, Resolve, Acumen) will follow in future releases.
Endpoint
The hosted MCP Server is available at:
https://api.fullcontact.com/v3/mcpAuthenticate with your existing FullContact API key — see Authentication. There is no infrastructure for you to operate.
Requirements
- An active FullContact account with API access.
- A FullContact API key with
person.enrichenabled. See Generate an API Key. - An MCP-compatible client (Claude Desktop, Claude Code, Cursor, VS Code with the MCP extension, ChatGPT with Connectors, or any other MCP-aware tool).
Next steps
- Quickstart — Connect the MCP Server to your AI client in under five minutes.
- Authentication — Where to obtain and how to pass your API key.
- Tool Reference:
enrich_person— Inputs, outputs, and example payloads.
Updated May 2026
Updated about 14 hours ago