# Contact List Merge Plan AI Agent Connect

> Contact List Merge Plan MCP helps you clean and unify contact datasets. It finds duplicate entries, identifies conflicting information, and picks the best master record for every unique identity. You can connect it to your AI client to handle the heavy lifting of data deduplication and identity resolution.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_b1AplyYYpD1NQOuHFl0SJQQ9g8Z2grksff5kQYcV/ai-agent-connect
- **Tags:** contacts, deduplication, data-cleaning, merge, identity-resolution

## Description

Managing contact lists often means dealing with messy, redundant, or conflicting data. This MCP gives your AI agent the specific tools needed to scrub these datasets and create a single source of truth. Instead of manually hunting for duplicates, you can have your agent group identical contacts by email, phone, or name. Once the duplicates are found, the agent can pinpoint exactly where the data differs between records. You don't have to guess which entry is the most accurate; the agent can deterministically select the most complete record to serve as the master. This turns a tedious manual cleanup task into a precise, automated process that ensures your contact information stays reliable and organized.

## Tools

### analyze_contact_duplicates
This tool groups duplicate contacts together based on the matching rules you choose, such as email or phone number.

### detect_field_conflicts
This tool finds specific discrepancies in data fields within identified duplicate groups.

### get_normalized_name_summary
This tool provides a count of unique identities when matching by normalized names.

### select_primary_record
This tool picks one specific record from a group to act as the master entry.

## Prompt Examples

**Prompt:** 
```
Find all duplicate contacts in this list based on their email addresses.
```

**Response:** 
```
I have identified 3 duplicate groups based on email addresses. There are 5 total duplicate records.
```

**Prompt:** 
```
Which contact should be the primary record for the group with ID 'group_123'?
```

**Response:** 
```
The primary record for group 'group_123' is contact ID 'user_882' because it contains the most complete information.
```

**Prompt:** 
```
How many unique identities are there if I match by normalized name?
```

**Response:** 
```
There are 45 unique identities found among the 50 provided contact records.
```

## Capabilities

### Duplicate Identification
Your agent uses this to group identical contacts using email, phone, or name matching.

### Conflict Detection
Your agent uses this to find where different contact records have conflicting information.

### Identity Counting
Your agent uses this to determine the total number of unique people in a dataset via normalized names.

### Master Record Selection
Your agent uses this to pick the most complete record to serve as the primary entry.

## Use Cases

### CRM Cleanup
Clean up a bloated CRM by identifying and merging duplicate customer profiles.

### Lead List Auditing
Check a new marketing lead list for duplicate emails before starting a campaign.

### Data Migration
Verify that contact data remains consistent and unique when moving from one system to another.

### Identity Resolution
Consolidate multiple records for the same person into a single, complete master profile.

## Benefits

- Reduces manual effort by automating the grouping of duplicate entries.
- Eliminates guesswork by deterministically selecting master records.
- Increases data accuracy by flagging specific field discrepancies.
- Speeds up contact list auditing through rapid identity counting.

## How It Works

Connect the MCP to your client and let your agent handle the data processing.

1. Connect the MCP to your AI client like Claude or Cursor via Vinkius.
2. Provide the contact dataset to your agent.
3. Instruct the agent to group duplicates using specific matching rules.
4. Have the agent identify data conflicts and select the best master records.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect to the MCP through the Vinkius platform. Once connected, your agent in Claude can immediately use the tools to process your contact data.

**Can I match duplicates by phone number?**
Yes, you can use the analyze_contact_duplicates tool to group contacts based on phone numbers or other selected matching rules.

**How does the MCP decide which record is the best one?**
The select_primary_record tool is designed to deterministically pick the most complete record from a group to serve as the master.

**Does this MCP host my data?**
Vinkius hosts the MCP so it is ready to run, but the tool is designed to process the data you provide to your agent during a session.

**What if my contact data has conflicting information?**
You can use the detect_field_conflicts tool to find specific discrepancies within your duplicate groups.

**How does the tool decide which contact is the primary record?**
The `select_primary_record` tool picks the record with the highest completeness (most non-empty fields). If there is a tie, it selects the record with the alphabetically first ID.

**What fields can I use to match contacts?**
You can match contacts using email, phone, or a normalized version of their name via the `analyze_contact_duplicates` tool.

**Can I check for specific field inconsistencies?**
Yes, use `detect_field_conflicts` and provide a list of field names you want to inspect for discrepancies within your merge groups.
