# MCP Server Overview

## 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

1. The AI client discovers the server's tool catalog and JSON Schema for `enrich_person`.
2. When the agent decides to enrich a person, it sends an MCP request through the configured client.
3. The MCP Server validates your API key, applies your account's rate limits, and forwards the request to `person.enrich`.
4. The response is normalized into a compact, agent-friendly JSON payload and returned to the client.

## Available tools

| Tool            | Purpose                                                 | Underlying API                                    |
|------------------|-------------------------------------------------------|--------------------------------------------------|
| `enrich_person`  | Resolve and enrich a person from email, phone, social, or name + location. | [`POST /v3/person.enrich`](https://docs.fullcontact.com/docs/multi-field-request) |

Additional tools (company enrichment, Resolve, Acumen) will follow in future releases.

## Endpoint

The hosted MCP Server is available at:

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

Authenticate with your existing FullContact API key — see [Authentication](https://support.fullcontact.com/portal/en/kb/articles/03-mcp-authentication.md). There is no infrastructure for you to operate.

## Requirements

- An active FullContact account with API access.
- A FullContact API key with `person.enrich` enabled. See [Generate an API Key](https://docs.fullcontact.com/docs/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](https://support.fullcontact.com/portal/en/kb/articles/02-mcp-quickstart.md) — Connect the MCP Server to your AI client in under five minutes.
- [Authentication](https://support.fullcontact.com/portal/en/kb/articles/03-mcp-authentication.md) — Where to obtain and how to pass your API key.
- [Tool Reference: `enrich_person`](https://support.fullcontact.com/portal/en/kb/articles/04-mcp-tool-enrich-person.md) — Inputs, outputs, and example payloads.
