# FeedBlitz MCP

> FeedBlitz MCP manages entire mailing lists, RSS feeds, and email marketing campaigns through your AI agent. It lets you automate subscriber growth by adding, removing, and tracking users across multiple syndications instantly. Get detailed publisher metrics, manage active lists, and monitor engagement without logging into a separate dashboard.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** rss-to-email, mailing-lists, subscriber-management, engagement-metrics, publisher-tools, syndication

## Description

Need to run a campaign but hate jumping between spreadsheets, list managers, and analytics dashboards? This MCP handles the whole workflow. It connects your AI agent directly to FeedBlitz’s back end, giving you control over every aspect of your outbound communications. You can dynamically manage subscriber lists, check user profiles for details, and even pull performance metrics for specific feeds—all without writing boilerplate code. When you connect this through Vinkius, it becomes one more powerful action available in your agent's toolkit. It takes the manual effort out of growing an audience; instead of managing contacts list by painful list, you just ask your AI client to handle the communication pipeline.

## Tools

### add_subscriber
Adds a specific email address to an existing mailing list (syndication).

### get_subscriber
Retrieves the profile details for a single, specified subscriber.

### get_syndication
Fetches detailed information about one specific mailing list or content feed.

### get_user
Retrieves the general user account details from FeedBlitz.

### list_metrics
Generates a report of key engagement metrics for an entire mailing list or feed.

### list_subscribers
Retrieves a filtered list of subscribers belonging to a syndication.

### list_syndications
Returns an overview and names of all active mailing lists and content feeds you manage.

### remove_subscriber
Unsubscribes or removes a specific user from a syndication.

## Prompt Examples

**Prompt:** 
```
List all my syndications in FeedBlitz.
```

**Response:** 
```
I've fetched your syndications. You currently have 3 active lists: 'Main Newsletter', 'Blog RSS Feed', and 'Product Updates'.
```

**Prompt:** 
```
Add newuser@example.com to syndication ID 123.
```

**Response:** 
```
Successfully added newuser@example.com to the syndication with ID 123.
```

**Prompt:** 
```
Show me the metrics for syndication ID 123.
```

**Response:** 
```
Here are the metrics for syndication 123: 500 active subscribers, 12 recent unsubscriptions, and an open rate of 42%.
```

## Capabilities

### Gauge Campaign Performance
Retrieve specific engagement metrics for any active mailing list or syndication.

### Manage User Profiles
Get detailed profile and account information on existing publishers within the system.

### List All Feeds/Lists
Retrieve a comprehensive list of all syndications (feeds and mailing lists) associated with your account.

### Control Subscriber Access
Add or remove specific contacts from any given syndication using simple commands.

## Use Cases

### Auditing a mailing list for compliance
The team needs to know exactly who is currently subscribed before running a major campaign. Instead of downloading a CSV and manually checking statuses, the agent runs `list_subscribers` on the target syndication ID. This gives them an immediate, filtered report they can review.

### Onboarding new content streams
A new product line requires three dedicated mailing lists and a corresponding RSS feed. The agent first uses `list_syndications` to check existing feeds, then uses the necessary tools to create and populate the required new lists automatically.

### Diagnosing poor campaign performance
The newsletter open rate dipped last month. Instead of guessing, the agent executes `list_metrics` on the main feed ID. The resulting data shows a specific drop in activity correlated with the date it was sent.

### Data cleanup after an acquisition
The company acquired three smaller blogs, each with its own subscriber list. Instead of manual merging, the agent uses `list_syndications` to identify all new lists and then cross-references them using `get_user` before consolidating.

## Benefits

- Stop manual data entry. Use `add_subscriber` to add new contacts instantly, letting your agent handle the plumbing instead of you.
- Track performance without clicking tabs. Run `list_metrics` to get immediate insights into open rates or active subscribers for any list.
- Maintain clean lists easily. If someone moves on, use `remove_subscriber` to immediately unsubscribe them across all feeds.
- Check user status fast. Need to know if a client exists? Use `get_user` to retrieve their full account details in seconds.
- Map your entire setup at a glance. Run `list_syndications` when you need an overview of every list and feed you manage.

## How It Works

The bottom line is you pass the secure API key to your agent; it handles all the necessary communication with FeedBlitz for you.

1. Subscribe to the FeedBlitz MCP and configure your necessary lists within the platform.
2. Obtain your API Key from the developer settings panel.
3. Provide that key to your AI agent, granting it permission to execute list management tasks.

## Frequently Asked Questions

**How do I see all the mailing lists available? (list_syndications)**
You run `list_syndications`. This tool returns an overview of every active list and feed you manage, giving you a master inventory to work from.

**Can I add a new user to a list using the add_subscriber tool?**
Yes. To add someone, use `add_subscriber` and provide the target syndication ID along with the email address you want to add.

**What is the difference between get_user and get_subscriber?**
`get_user` pulls general account details for a publisher. `get_subscriber` focuses specifically on one person's status within your mailing lists.

**How do I check engagement metrics using list_metrics?**
Specify the syndication ID you want to check and call `list_metrics`. The agent will return key performance data, like open rates and active counts.

**What parameters does the `remove_subscriber` tool require to ensure a successful unsubscription?**
It requires the syndication ID and the subscriber's email address. This method handles both active removal and simple unsubscription requests, making it easy to clean up lists when necessary.

**If I need more than just the name, how can I get all details for one list using `get_syndication`?**
Using `get_syndication`, you retrieve a complete profile of a specific feed. This goes beyond simple names and gives you structural details about the syndication itself.

**Can I use `list_subscribers` to filter for inactive or pending users?**
Yes, you can filter results using status parameters within the `list_subscribers` tool. This lets your agent pull only certain groups of users from a large list.

**What happens if I use `get_subscriber` but don't have an exact subscriber ID?**
You can typically pass the email address to the `get_subscriber` tool. It finds and verifies details for that specific user, even if you don't have their internal account identifier.

**Can the AI Agent send bulk email campaigns directly?**
No, the agent currently focuses on managing lists, syndications, and subscribers. Campaigns are typically dispatched automatically via RSS by FeedBlitz.

**Does the FeedBlitz MCP support filtering subscribers by status?**
Yes, you can instruct the AI to filter subscribers by providing a specific status like active or unsubscribed when querying a syndication.

**Are metrics retrieved in real-time?**
Metrics reflect the latest data available in FeedBlitz's systems, providing near real-time insights into your syndication's performance.