# Joomag MCP

> Joomag MCP gives your agent programmatic access to manage digital publications, issues, and audience data. Use it to retrieve metadata for entire content lines, track specific editions, audit subscriber lists, and pull performance analytics from marketing campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** digital-publishing, content-distribution, audience-analytics, marketing-campaigns, media

## Description

Need to automate content distribution or build a custom dashboard around media performance? This MCP connects your AI client directly into the Joomag publishing platform. You can programmatically list all publications, check their high-level branding settings, and map out their full history by pulling every associated issue ID. It lets you go deeper than just titles; you can track who is subscribed using `list_subscriptions` or audit specific audience records with `list_contacts`. If you're building a marketing automation pipeline, this MCP helps your agent monitor active campaigns and view overall performance analytics in one place. Through Vinkius, you get to connect this Joomag data alongside other services—meaning your AI client can execute complex workflows like notifying an editor when campaign views dip below a threshold. It’s all about taking the raw content metadata and turning it into actionable intelligence for your business.

## Tools

### get_account
Retrieves the overall Joomag account details for system verification.

### get_issue
Gets detailed information about a single, specific edition of content.

### get_publication
Returns the high-level setup data, branding, and access rules for an entire publication line.

### list_analytics
Lists aggregated reports on content performance, views, and general engagement trends.

### list_campaigns
Provides a list of all active marketing campaigns running through Joomag.

### list_collections
Lists thematic groupings, helping organize content into logical categories.

### list_contacts
Retrieves the full list of contacts, including their name, email, and current subscription status.

### list_issues
Lists every specific version or date-based release associated with a given publication ID.

### list_publications
Returns titles, IDs, and basic settings for all publications managed by the account.

### list_subscriptions
Lists every active subscription record to audit paid or registered user access.

## Prompt Examples

**Prompt:** 
```
List all my digital publications in Joomag.
```

**Response:** 
```
I'll fetch the list of your digital publications for you.
```

**Prompt:** 
```
Show me the issues for publication ID '456'.
```

**Response:** 
```
I'll retrieve all issues associated with that specific publication.
```

**Prompt:** 
```
Check the latest audience analytics report.
```

**Response:** 
```
I'll look up the performance analytics for your Joomag account.
```

## Capabilities

### Retrieve Publication Metadata
Gets high-level details, branding rules, and configuration settings for an entire digital publication.

### List Available Content Lines
Retrieves a list of all publications available in the Joomag account.

### Track Audience and Subscription Status
Audits the contact list, checks active subscriptions, or lists collections for content organization.

### Monitor Content Performance
Pulls detailed analytics reports showing overall views, engagement trends, and campaign results.

### Manage Specific Editions
Fetches the content details for a single, specific issue or edition of a publication.

## Use Cases

### The Quarterly Performance Audit
A marketing manager needs to prepare a report showing total views, top campaigns, and subscriber count. The agent runs `list_analytics` for overall performance, then calls `list_campaigns` to narrow the focus, and finally uses `list_subscriptions` to provide context on who is accessing the content.

### Onboarding a New Publication
A product team needs to validate the new branding rules for a publication before launch. They first run `get_publication` to check metadata, then use `list_collections` to place it within existing organizational structures.

### Auditing User Access Rights
An admin needs to know if specific users have paid access. The agent calls `list_contacts` to get the master list and then uses `list_subscriptions` to filter down exactly who has viewing rights.

### Content Deprecation Check
A developer needs a complete history of content for compliance purposes. They first use `list_publications` to find the ID, and then call `list_issues` to retrieve every single historical version associated with that publication.

## Benefits

- Automate content lifecycle management. Instead of manually checking publication details, you can use `list_publications` to programmatically identify every available digital asset.
- Get a 360-degree view of your audience. You audit paid access using `list_subscriptions` and manage contact records by pulling data from `list_contacts`—all in one call.
- Pinpoint campaign ROI instantly. Use `list_campaigns` to see which marketing efforts are running, then cross-reference that with performance metrics via `list_analytics` to measure true impact.
- Deep dive into content history. When you need to know the specifics of a past release, don't rely on finding it in an archive; use `get_issue` to pull every data point for a specific edition ID.
- Organize sprawling media assets. Need to group related articles? Use `list_collections` to identify thematic groupings and then cross-reference those groups with the master list of publications using `list_publications`.

## How It Works

The bottom line is you get a structured API endpoint that feeds publication and audience data directly into your running application logic.

1. First, your agent calls `get_account` to verify access and ensure system health.
2. Next, you use tools like `list_publications` and `list_issues` to retrieve the necessary content IDs and metadata.
3. Finally, your agent passes these specific identifiers to functions like `get_issue` or `list_analytics` to pull the final, actionable data set.

## Frequently Asked Questions

**How do I check if a user is paying for content using Joomag MCP?**
You use the `list_subscriptions` tool. This function provides a comprehensive list of all active subscriptions, allowing you to audit exactly which users or groups have paid access to restricted content.

**What is the best way to track performance metrics with Joomag MCP?**
To get full performance data, start by calling `list_analytics`. This gives a high-level overview, which you can then refine by running `list_campaigns` to see the specific marketing efforts driving that traffic.

**Can I find out all past versions of an article using Joomag MCP?**
Yes. First, use `list_publications` to get the main ID, then run `list_issues` against that ID. This reliably lists every specific version or date-based release associated with the publication.

**Does Joomag MCP help me manage my subscriber list?**
It helps you audit it. The `list_contacts` tool retrieves names and emails, while `list_subscriptions` confirms their active paying status, giving you a complete picture of your audience.

**How do I use `list_publications` to see all available digital titles in Joomag?**
The tool returns a list of every publication title and ID. This lets you know exactly which content sources are available for your AI client to manage or analyze.

**What should I do if I need to verify my connection status using `get_account`?**
Run the `get_account` tool. This instantly retrieves core Joomag account details, letting you confirm your API access and check system health before running deeper tasks.

**Can I use `list_collections` to understand how content is organized within Joomag?**
Yes, `list_collections` provides a hierarchical view of all publication groupings. Use this when you need to identify thematic areas or organizational categories for your content strategy.

**How do I use `get_publication` to understand the setup details of a specific title?**
`get_publication` pulls metadata, branding settings, and access configurations. This is perfect for understanding the high-level setup requirements before running analytics on one particular digital publication.

**How do I get Joomag API credentials?**
Log in to your Joomag account, navigate to API Settings, and generate a new Access Token.

**Can I see issue details?**
Yes, you can list all issues for a publication and retrieve detailed information for any specific issue.

**Does it support audience analytics?**
Yes, the list_analytics tool provides access to reports and data regarding your publication's performance.