# Get a Newsletter MCP MCP

> Get a Newsletter MCP manages your entire email marketing life cycle through natural conversation. List, segment, and update contacts, or pull detailed reports on past campaigns—all without logging into the web platform. It gives you full control over subscriber lists and campaign performance directly from any AI client.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** newsletter-management, subscriber-lists, campaign-tracking, contact-management, email-automation, list-segmentation

## Description

Need to manage subscribers or track campaign performance but don't want to open a new browser tab? This MCP lets your agent handle all of that. You talk to it like talking to an experienced marketing assistant, and the tool executes complex actions against your Get a Newsletter account. Instead of jumping between tabs just to check if a user is active or pull last month's campaign metrics, you ask your AI client for the data. It pulls everything—from checking specific contacts to building brand new subscriber lists, all while keeping your workflow in one place. When using Vinkius, this MCP syncs up with your preferred agent, making it feel like a dedicated marketing backend that just listens to what you need done.

## Tools

### create_contact
Adds a new subscriber record into your audience.

### create_list
Builds a brand new, empty list for segmenting subscribers.

### delete_contact
Removes an existing subscriber record from your audience.

### get_campaign
Pulls detailed information about one specific email campaign.

### get_contact
Retrieves all metadata for a single subscriber by their address or ID.

### get_list
Gets the full details and membership count of a specific list.

### list_campaigns
Lists every campaign you've ever created or sent.

### list_contacts
Retrieves a full roster of all current subscribers in your account.

### list_lists
Shows you every segment list currently available.

### update_contact
Modifies specific data points for an existing subscriber, like updating a name or status.

## Prompt Examples

**Prompt:** 
```
List all our email campaigns on Get a Newsletter.
```

**Response:** 
```
I've fetched your campaigns. You have 'Q4 Product Launch' (sent) and 'Weekly Digest' (draft). Would you like to inspect any of them?
```

**Prompt:** 
```
Add a new subscriber john.doe@example.com with the name John Doe.
```

**Response:** 
```
Success! I have created the new contact John Doe (john.doe@example.com) in your Get a Newsletter audience.
```

**Prompt:** 
```
Check if we have a subscriber list available and create a new one called 'Beta Testers'.
```

**Response:** 
```
I found one existing list named 'Default Audience'. I have now created the new list 'Beta Testers' successfully.
```

## Capabilities

### Manage Contacts
Create new subscribers, modify existing contact details, or remove accounts entirely.

### View Subscriber Lists
See all active lists and create segmented groups for targeted emails.

### Check Specific Contacts
Fetch deep details on any specific subscriber, including their current status and metadata.

### Audit Campaigns
List all past campaigns or get the full report for one specific email send.

## Use Cases

### Auditing a Campaign Launch
A Marketing Manager needs to check if last week's 'Product Update' campaign ran successfully. They ask their agent, and it immediately uses `list_campaigns` to show the name, status, and date of the send. This avoids manually digging through reports.

### Onboarding a New Client
An Engineering Team is setting up a new data pipeline hook. They use `get_contact` to pull a test user's full metadata, verifying that the integration can read and write all required fields before going live.

### Segmenting Leads After an Event
A Content Strategist just gathered 50 new sign-ups. They ask the agent to create a list called 'Conference Attendees' using `create_list`, and then use `create_contact` for each person, keeping their data organized immediately.

### Cleaning Up Inactive Records
A Founder realizes they have many old contacts who never engaged. They ask the agent to `list_contacts` and identify users who haven't opened an email in a year, allowing them to run a mass deletion through `delete_contact`.

## Benefits

- You can instantly see which campaigns were sent or are still drafts by asking the agent to `list_campaigns`, without ever navigating to the marketing dashboard. This saves time and keeps you in flow.
- Need to add a new lead? Just ask your agent to use `create_contact` with their email, name, and metadata. It handles the submission process immediately.
- Before running any campaign, verify the list structure. The MCP lets you run `list_lists` to see all segments or use `get_list` to audit a specific group's membership size.
- If a subscriber changes their job title or status, instead of logging in and finding them, just prompt your agent to execute `update_contact`. It handles the record change instantly.
- Want to clean up old data? Use `delete_contact` via the MCP. You can remove accounts safely without leaving your current terminal window or application.

## How It Works

The bottom line is that your AI client uses the API token to talk directly to Get a Newsletter's backend on your behalf.

1. First, subscribe to this MCP and provide your Get a Newsletter API Token.
2. Your AI client recognizes the connection and makes the tools available in conversation.
3. You simply ask your agent for what you need—for example, 'Show me all contacts who haven't opened an email in 90 days.' — and get the data back.

## Frequently Asked Questions

**How do I use the get_campaign tool with Get a Newsletter MCP?**
You ask your agent to run `get_campaign` and specify the campaign name or ID. It pulls all the detailed information, including send status, recipient count, and overall performance metrics.

**Can I use list_contacts for bulk operations?**
Yes. You can ask your agent to run `list_contacts` to get a full roster of all subscribers. From there, you can guide it through using tools like `delete_contact` or grouping them into lists.

**What is the difference between create_list and list_lists?**
`list_lists` shows you every existing segment right now. If you need a new segment, you use `create_list`. It handles making sure your audience segmentation is accurate.

**Does update_contact overwrite all data if I forget a field?**
No. The tool only updates the fields you specify in the command. This lets you safely modify just one piece of information, like a name or status, without risking other contact details.

**If I use `delete_contact` for an email address that isn't in my system, will it throw an error?**
No, it won't fail. The tool is designed to handle missing records gracefully; instead of throwing an error, it simply reports back that the contact wasn't found so your script doesn't crash.

**What specific metadata does `get_contact` return for a single subscriber?**
It pulls all current details for that specific contact, including their precise subscription status and any custom fields assigned to them. This gives you the full context without having to list every person.

**How does `get_list` help me check an audience segment's scope?**
It returns the list's name, its total member count, and whether or not that list is currently active. This helps confirm which segments are ready for you to send campaigns from.

**If I suspect my connection is down, what is the best way to verify it using `list_campaigns`?**
Running `list_campaigns` is the fastest test. If you receive a list of campaign names—even if that list happens to be empty—it means your API token works and the MCP can talk to the marketing platform.

**Can my AI automatically create a new subscriber and assign them a name?**
Yes! Use the `create_contact` tool with the email address and optional first/last name. Your agent will instantly register them in your Get a Newsletter database.

**How do I check my previous or active email campaigns?**
Simply ask the agent to run the `list_campaigns` action. It will retrieve the latest sent, scheduled, or drafted email campaigns available in your account.

**Can this integration delete my entire account or lists?**
No. The integration allows targeted deletions of specific contacts (`delete_contact`), but it does not expose destructive actions to wipe entire lists or account-level configurations.