# Drift MCP MCP

> Drift connects your AI agent directly to your conversational marketing platform. It lets you pull customer transcripts, track contact profiles with specific attributes, check agent availability in real-time, and monitor the status of all automated playbooks via natural language commands.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** conversational-marketing, sales-engagement, live-chat, customer-conversations, lead-qualification

## Description

Need to know what a prospect was talking about three months ago? This MCP gives your AI agent access to every conversation record and detailed contact profile within Drift. You can instantly pull full transcripts for any customer interaction or list out every person identified in your system, along with their custom attributes. It's the deep context layer that turns raw data into actionable intelligence.

Beyond just chatting through records, you get a clear view of who’s on shift and which automated playbooks are active. You can also look up platform metadata to understand exactly how your Drift account is configured. Because every action happens inside Vinkius, you don't have to worry about data integrity; you can trust that everything the agent pulls through is logged and visible through Vinkius AI Analytics.

## Tools

### get_contact_profile
Fetches a specific person’s full profile data, including their complete interaction history with your company.

### get_conversation_details
Retrieves detailed information and the entire chat transcript for one specific conversation thread.

### get_drift_platform_metadata
Pulls basic system data about your current Drift account, useful for auditing setup details.

### list_drift_agents
Lists all users and agents registered within the Drift organization so you know who is on staff.

### list_drift_contacts
Provides a list of every contact that has been synchronized or identified in your account.

### list_drift_conversations
Retrieves a comprehensive list of all customer chats, both active and recent.

### list_drift_playbooks
Lists every configured conversational bot or playbook, showing its status to you.

### list_latest_customer_interactions
Identifies the most recently updated customer chats so you can prioritize where your attention is needed.

### quick_agent_availability_audit
Provides a quick summary of how many agents are currently available versus away from chat duty.

### search_contacts_by_email
Searches the contact database using an email address to find associated profiles and data.

## Prompt Examples

**Prompt:** 
```
List all active Drift conversations.
```

**Response:** 
```
I've found 5 active conversations, including interactions with 'John Doe' and 'Anonymous Visitor #123'. Would you like to see the transcript for the conversation with John Doe?
```

**Prompt:** 
```
Show me the contact profile for 'robert.brown@example.org'.
```

**Response:** 
```
Robert Brown is a known contact from 'Tech Corp'. He has had 3 previous conversations and was last seen 2 hours ago. His profile includes attributes for 'Job Title: CTO' and 'Location: London'. Should I pull his full interaction history?
```

**Prompt:** 
```
Who is currently available to take chats in Drift?
```

**Response:** 
```
Currently, 3 agents are 'Available': 'Alice Johnson', 'Bob Miller', and 'Kenji Tanaka'. 2 other agents are 'Away'. Would you like to see the current conversation load for the available agents?
```

## Capabilities

### Get Contact Profiles
Retrieve a specific contact’s full profile, including their history with your company.

### View Conversation Transcripts
Access detailed information and the complete chat transcript for any given conversation thread.

### List All Contacts
Generate a list of every contact synced or identified within your Drift account.

### Check Agent Status
Get an immediate, high-level summary of which team members are currently available to chat.

### List Conversational Playbooks
See all the automated bots and playbooks you have configured in Drift and their current status.

## Use Cases

### The Onboarding Follow-Up
A new Customer Success Manager needs to follow up with a client. Instead of asking for details, they use `get_contact_profile` first. The agent immediately sees the client's job title and three previous conversations, allowing them to tailor their pitch perfectly.

### The Incident Response
A critical customer reports a bug late Friday afternoon. The team uses `list_latest_customer_interactions` to see who was last active. They then check the availability using `quick_agent_availability_audit` to route the chat to an available Tier 2 specialist immediately.

### The Sales Audit
A Sales Manager needs proof of recent engagement for a quarterly review. They call `list_drift_conversations` and then use `get_conversation_details` on the top five records to quickly prove active selling.

### The Outreach Campaign
Marketing Ops needs to validate their list of leads. They run `list_drift_contacts` to ensure all required fields are populated, then use `search_contacts_by_email` on a test batch to verify the data flow.

## Benefits

- Stop guessing. Use `get_contact_profile` to pull up a prospect’s entire history, seeing what they talked about months ago without needing to manually search through multiple dashboards.
- Never be caught off guard again. Running `quick_agent_availability_audit` gives you an instant status report on your team, letting you redirect high-priority chats immediately.
- Contextualize conversations instantly. If you need the full story, running `get_conversation_details` provides the complete chat transcript for review in seconds.
- Keep track of automated funnels. By calling `list_drift_playbooks`, your agent can report on which bots are active and how they are performing right now.
- Find leads fast. You can use `search_contacts_by_email` to locate a person’s profile using just their email, skipping the initial search step entirely.

## How It Works

The bottom line is you don't have to switch between tabs or run separate searches; the entire conversation context flows directly into your agent.

1. You authorize the MCP using your personal access token or OAuth credentials.
2. Your agent sends a prompt, asking for specific customer data, like 'What did Robert Brown discuss last week?'
3. The MCP executes the necessary tool call and returns the full profile and transcripts to your AI client.

## Frequently Asked Questions

**Can I check agent availability using get_drift_platform_metadata?**
No, `get_drift_platform_metadata` pulls system setup details for your account. To know who is currently available to chat, you must use the dedicated tool: `quick_agent_availability_audit`.

**How do I see a client's entire history with get_contact_profile?**
`get_contact_profile` pulls all of it. It doesn’t just give you the name; it delivers their full profile, including every past interaction and any custom attributes logged in Drift.

**Does list_drift_conversations show me live chats?**
`list_drift_conversations` shows a comprehensive list of conversations. If you need to know which chats are happening *right now*, use `list_latest_customer_interactions` for the most up-to-date view.

**What if I only have an email, how do I find their details?**
Use `search_contacts_by_email`. This tool takes an email address and immediately returns the contact's associated profile data from Drift.

**When using `get_drift_platform_metadata`, what credentials do I need for authentication?**
You need a valid Drift Personal Access Token or OAuth Token. The MCP uses this token to authenticate your connection and confirm which account you're interacting with. If the token is expired, the call will return an authentication failure error.

**What happens if I try to pull too many records using `list_drift_contacts`?**
The system enforces rate limits to protect your account. When you hit a limit, the MCP response will include specific headers detailing the rate limit window and how long you must wait before trying again.

**How do I check the activation status of my bots using `list_drift_playbooks`?**
The tool returns a list of all configured playbooks (bots) along with their current activation state. This allows you to programmatically verify if a bot is live, paused, or needs updating.

**Does `list_drift_conversations` include transcripts from historical chats?**
It lists the conversations themselves, providing IDs and recent activity summaries. To get the full transcript details for any specific conversation, you must use the separate `get_conversation_details` tool.