# Fidelizador MCP

> Fidelizador MCP connects your AI agent directly to a loyalty marketing platform. You can programmatically manage contacts, build new mailing segments, and track detailed campaign performance without touching the web dashboard. It gives you full control over audience data and automated email campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** audience-segmentation, loyalty-programs, personalized-campaigns, contact-management, engagement-tracking, rewards

## Description

Manage your customer base entirely through natural conversation. This connection lets you treat your email marketing and automation workflows like a simple chat session with your dedicated coordinator. Need to update John Doe's phone number? Just ask it. Want to see the open rates for last month’s newsletter? Get the stats instantly. You can build new segments, monitor active campaign performance, or clean up old contact records—all without logging into the platform. It moves complex tasks like listing contacts and checking campaign statuses from a tedious dashboard navigation into simple conversation commands. Because this MCP is hosted on Vinkius, your agent gets access to all these actions in one place, turning difficult marketing data management into quick conversational queries.

## Tools

### create_contact
Adds a brand new person's profile to the Fidelizador database.

### create_mailing_list
Sets up and names a completely new segment for grouping contacts.

### delete_contact
Removes an existing contact record from the system.

### get_campaign
Fetches all specific performance metrics and details for a single, identified campaign ID.

### list_campaigns
Returns an overview of every email campaign that has been run or is currently active.

### list_contacts
Retrieves a directory listing of contacts, allowing you to see who's in the system.

### list_mailing_lists
Provides an overview of all mailing segments that have been created for audience grouping.

### update_contact
Modifies specific data points on a contact, like changing their email or adding custom notes.

## Prompt Examples

**Prompt:** 
```
List all my email campaigns in Fidelizador.
```

**Response:** 
```
I've retrieved your campaigns. You have 3 active mailings, including 'Spring Promotion 2026' (ID: 101) and 'Product Newsletter'. Would you like the open rates for any of these?
```

**Prompt:** 
```
Create a new contact 'John Doe' (john@example.com) in Fidelizador.
```

**Response:** 
```
Contact created! John Doe has been successfully added to your Fidelizador database. Shall I add him to a specific mailing list now?
```

**Prompt:** 
```
Show me the details for campaign ID '101'.
```

**Response:** 
```
Fetching campaign 101... This 'Spring Promotion' had a 25% open rate and a 5% click-through rate. It was delivered to 1,500 recipients. Would you like a breakdown by list?
```

## Capabilities

### Manage Contacts
Create new customer profiles, update existing records (like email or phone numbers), or remove contacts entirely from the system.

### Build Audience Lists
List all available mailing segments and create brand-new groups to organize your audience for specific campaigns.

### Monitor Campaigns
Retrieve details and performance statistics for past or active email marketing efforts, giving you instant reporting on open rates and delivery volume.

## Use Cases

### Need to adjust an old lead's info?
A CRM Admin needs to update Jane Smith’s job title and phone number because her department changed. They tell their agent, which runs the `update_contact` tool, so they don't have to navigate into the contact details page.

### Launching a targeted campaign:
A Digital Marketer wants to run a flash sale only for users who bought product X. They first use `list_mailing_lists` to check existing segments, then tell their agent to create a new list using `create_mailing_list`, and finally, they trigger the send.

### Checking last quarter's performance:
A Marketing Analyst asks for the open rates of the 'Q3 Product Announcement.' The agent uses the `get_campaign` tool, instantly pulling metrics that would otherwise require navigating to a separate reporting dashboard.

### Onboarding new leads in bulk:
A Sales Team member gathers 20 new contacts. Instead of manually entering each one, they ask their agent to run `create_contact` for the batch, building them directly into the Fidelizador system.

## Benefits

- Update records instantly. Instead of manually logging in to change a contact's email or phone number, you tell your agent to do it. Use the `update_contact` tool and get immediate confirmation.
- Segment smarter. Need a new group for 'High-Value Leads'? You can use `create_mailing_list` via natural language commands instead of building the segment in the dashboard GUI.
- See campaign results fast. Instead of digging through reports, just ask your agent to run `get_campaign` on ID 101 and get its open rate right away.
- Maintain data hygiene. Use `delete_contact` when a user leaves or is inactive. You keep your database clean without leaving your main AI chat window.
- View all options at once. Easily see what you can do by running `list_mailing_lists` to review every existing segment before starting a campaign.

## How It Works

The bottom line is: your AI acts as your direct marketing coordinator for this platform.

1. Subscribe to this MCP and grab your API key from Fidelizador's integration settings.
2. Connect the credentials in your preferred client (like Cursor or Claude).
3. Ask your agent a question, like 'List all my campaigns,' and it executes the necessary actions.

## Frequently Asked Questions

**How do I list all my campaigns using the Fidelizador MCP?**
You ask your agent to run `list_campaigns`. It will return an overview of every email campaign, giving you a quick directory and their status.

**Can I update contact information with the Fidelizador MCP?**
Yes. Just tell your agent to use the `update_contact` tool, specifying which piece of data (like phone or email) needs changing for a specific person.

**What is the difference between listing contacts and mailing lists in Fidelizador?**
The `list_contacts` tool shows every individual person profile. The `list_mailing_lists` tool only shows the names of the segments you've created for grouping them.

**Does the Fidelizador MCP let me create new lists?**
Yep. You can ask your agent to use `create_mailing_list`, and it will set up a completely new segment in the platform for you to start adding people to.

**What precautions should I take when using the `delete_contact` tool?**
The MCP performs an immediate deletion of the contact record. Before running `delete_contact`, always run `list_contacts` first to verify you are targeting only stale or inaccurate profiles, preventing accidental data loss.

**Using the `get_campaign` tool, what performance metrics can I retrieve?**
You get detailed stats like open rates and click-through rates for that specific campaign. The tool also reports the total number of recipients and delivery status, giving you a clear picture of campaign success.

**What credentials are needed to set up my account with the Fidelizador MCP?**
You only need your API Key for connection. You retrieve this key directly from your Fidelizador settings under Integrations, allowing your AI client secure access without needing manual logins.

**When using `create_contact`, what information must I provide to ensure data integrity?**
You must supply at least a valid email address and the contact's full name. Providing phone numbers and custom data points enhances data quality, making subsequent campaigns more targeted.

**How do I find my Fidelizador API Key?**
Log in to your Fidelizador account, navigate to **Settings** > **Integrations**, and generate or copy your unique API Key.

**Can I search for a contact by email?**
The `list_contacts` tool retrieves your directory. You can ask your agent to find specific records by email within the returned data.

**How do I create a new mailing list?**
Use the `create_mailing_list` tool and provide a name for your new list. The agent will confirm the creation in your account.