# Quentn MCP

> Quentn MCP Server gives your AI agent full control over CRM and marketing automation. You can manage contacts, update records, trigger campaigns, and track tags—all from a single chat interface. It's built for GDPR compliance and complex marketing workflows targeting German-speaking markets.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** crm-automation, email-funnels, gdpr-compliance, lead-management, workflow-sequences

## Description

**Quentn MCP Server - CRM Automation & Email Funnels** gives your AI agent full control over Quentn's entire customer relationship management system, letting you manage contacts, update records, trigger campaigns, and track tags directly from the chat. You create new profiles using `create_contact`, specifying all necessary details for a brand-new lead; you modify existing client data with `update_contact` by changing roles or company names without losing history. If a record is totally dead, you can permanently remove it using `delete_contact`. To check the profile of any specific person, your agent fetches all available information via `get_contact`, requiring only their unique ID.

## Tools

### create_contact
Creates a brand new contact record in Quentn with specific details.

### delete_contact
Permanently removes an existing contact record from the system.

### get_campaign
Retrieves full operational details for a specific marketing campaign ID.

### get_contact
Fetches all available profile data for a single contact using their unique ID.

### get_tag_details
Retrieves the definition and details of one specific audience tag or term.

### list_campaigns
Returns a list of all currently active marketing campaigns available in Quentn.

### list_contacts
Retrieves a comprehensive, filterable list of every contact record in the system.

### list_tags
Lists all predefined tags or terms used for segmenting your user base.

### list_users
Outputs a list of authenticated system users connected to the Quentn instance.

### send_email
Sends an immediate, automated email message to any specific contact in the database.

### update_contact
Modifies one or more fields on an existing contact record without deleting it.

## Prompt Examples

**Prompt:** 
```
List all contacts tagged as 'VIP' in Quentn.
```

**Response:** 
```
I've retrieved your contacts. You have 12 active profiles tagged as 'VIP', including 'Alice Brown' and 'Acme Corp'. Would you like to check the engagement for any of them?
```

**Prompt:** 
```
Show me all contacts who opened my last email campaign but did not click any link.
```

**Response:** 
```
234 contacts opened the "May Product Update" campaign but did not click. Open rate: 42% (234 of 557 recipients). Click rate for these openers: 0%. Top segments: "Trial Users" (89 contacts), "Inactive 30 days" (67), "Newsletter Only" (48). Average time spent on email: 4.2 seconds (suggests scanning, not reading). Recommendation: A/B test subject lines and move CTAs above the fold for this cohort. 12 contacts are tagged as "High Value" and may benefit from personalized follow-ups.
```

**Prompt:** 
```
Create a new contact with tag VIP Customer and add them to the onboarding automation sequence.
```

**Response:** 
```
Contact created successfully. Name: Alexandra Petrov. Email: a.petrov@scaleup.io. Tag: VIP Customer applied. Added to automation: "VIP Onboarding Sequence" (5 emails over 14 days). First email "Welcome to VIP" scheduled to send in 15 minutes. The contact has been assigned to your CRM with lead score: 85/100. Custom fields populated: Company: ScaleUp Inc, Role: Head of Product, Source: Partner Referral.
```

## Capabilities

### Manage Contact Records
You create new profiles or update existing ones with custom data points like roles, company names, and lead scores.

### Control Audience Tagging
You list all existing tags or apply specific terms to contacts to segment your audience for targeted campaigns.

### Orchestrate Campaigns
You retrieve details on active marketing campaigns and trigger specific sequences for groups of users.

### Send Targeted Emails
You send automated emails directly through the Quentn system to any specified contact.

### View User Lists
You list all known system users within your connected Quentn account for auditing or verification purposes.

## Use Cases

### Lead Status Check
An SDR needs to know if a prospect, 'Jane Doe,' has been tagged as 'High Value' and what their last known role is. Instead of jumping through three different tabs (CRM -> Tags -> Contact), they ask the agent: 'What are Jane Doe's tags and current title?' The agent runs `get_contact` and instantly returns the metadata.

### Post-Event Cleanup
The Marketing Manager ran a big webinar. Now, 50 attendees need to be added and tagged as 'Webinar Lead' and sent an immediate follow-up email. They prompt: 'Create a new tag called Webinar Lead; then use `list_contacts` for the list of signups and run `send_email`.' The whole sequence runs in chat.

### Audience Segmentation Validation
The Ops team wants to confirm if they are segmenting correctly. They ask: 'List all tags that start with the word 'Beta'.' The agent executes `list_tags` and filters the results, giving immediate proof of segmentation structure.

### Data Correction
A contact's company name was entered incorrectly in a spreadsheet. Instead of finding the ID manually and updating it, they ask: 'Update the contact associated with email x@example.com; change their company to Acme Corp.' The agent finds the record and runs `update_contact`.

## Benefits

- Audit your audience instantly. Instead of navigating to the 'Tags' section just to check names, run `list_tags` via your agent to see every term you use right now.
- Sync records without leaving your IDE. You can get a contact's current details using `get_contact` and immediately pass that data off for analysis—no copy-pasting required.
- Automate outreach at scale. Need to send a welcome email? Your agent handles the full sequence: identify the recipient, then run `send_email`. It’s one prompt away.
- Keep your database clean. When a lead changes roles or departments, use `update_contact` through chat. You modify fields and tags without touching any forms or dashboards.
- Know what's running. Running `list_campaigns` shows you every current funnel status—Are we running the Q3 campaign? Which one is active? Know it in seconds.

## How It Works

The bottom line is: you treat your entire marketing stack—CRM, email sender, tagging system—as a single conversation with your AI client.

1. Subscribe to the server and enter your unique Quentn API Key and Base URL.
2. Your AI agent accesses the tool suite, allowing it to read contact metadata, list campaigns, or send emails when prompted.
3. You instruct your agent in natural language (e.g., 'List all contacts tagged as High Value') and receive structured data back immediately.

## Frequently Asked Questions

**How do I use `list_contacts` with Quentn MCP Server?**
You ask your agent to list contacts, specifying filters like 'Show me all contacts tagged as VIP.' The server runs `list_contacts` and returns only the filtered results.

**Can I use `send_email` if the contact ID is old?**
The tool requires a valid, existing contact record. If you suspect an ID is stale or wrong, run `get_contact` first to verify the profile details before attempting to send mail.

**What's the difference between `list_tags` and `get_tag_details`?**
`list_tags` gives you a roster of every tag available. You use `get_tag_details` when you need to know what a specific, single tag actually contains or represents.

**Does `update_contact` overwrite all the data?**
No. The tool only updates the fields you explicitly provide in the prompt. You can update just one field (like 'Role') while leaving everything else untouched.

**What credentials are necessary to run the `create_contact` tool?**
You must provide your Quentn API Key and Base URL. Your AI client sends these details upon connection, allowing the agent to authenticate against your account and perform the contact creation on your behalf.

**If I run `get_contact` for a non-existent ID, how is the error handled?**
The server returns a specific 'Contact Not Found' status code. Your agent reads this response and can then prompt you to check nearby IDs or use `list_contacts` to find the correct record.

**When I run `list_campaigns`, what key data points are returned?**
The initial list provides core campaign metadata, including the Campaign Name and its current Status. You need to use the corresponding `get_campaign` tool with an ID for full details.

**How does the `list_users` tool help manage system access?**
This tool retrieves a list of all internal system user accounts tied to your Quentn instance. Operational teams use it to audit who has access and monitor organizational permissions.

**Can my AI automatically find the details for a specific contact just by providing their ID?**
Yes! Use the `get_contact` tool. Your agent will respond with complete metadata, including tags, custom fields, and engagement history in seconds.

**Where do I find my Quentn Base URL?**
Log in to Quentn, go to **My Account** > **API Info**. Your unique base URL follows the pattern `https://..quentn.com/public/api/V1`.

**How do I add a tag to a contact?**
Use the `update_contact` tool and include the new tag in the 'terms' field of the request body.