# Evvnt Marketing & Distribution MCP

> Evvnt Marketing & Distribution connects your AI agent directly to the Evvnt event platform. Manage everything from initial concept listing to post-campaign reporting. You can run marketing audits, check detailed event statuses, monitor total sites reached, and list out all saved venues without leaving your chat interface.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** event-promotion, syndication-reporting, marketing-distribution, event-listings, audience-reach, campaign-tracking

## Description

You shouldn't have to jump between dashboards just to track one event's performance. This MCP lets you manage your entire event lifecycle using natural language conversations. Think of it like giving your AI agent a pass key to the Evvnt platform, allowing it to perform actions and retrieve data directly where you are working. You can list all promoted events and pull detailed reports on distribution success right out of the chat window. It's about turning complex operational oversight into simple dialogue.

When you connect this through Vinkius, your AI client gets access to a powerful catalog of tools that let you monitor everything from syndication partner networks to high-level account metadata. You don’t just read data; your agent can act on it—for instance, finding out which events are still in 'Draft' status or pulling immediate summaries of how far the promotion has spread. This means less time clicking through reports and more time making decisions.

## Tools

### get_evvnt_account_metadata
Retrieves the general limits and data metadata for your Evvnt account.

### get_event_distribution_reports
Pulls performance reports showing where and how many times a single event was shown.

### get_event_detailed_data
Gets the full settings and distribution info for one specific event.

### quick_event_marketing_audit
Provides a quick, high-level summary of your total event volume and distribution reach.

### list_event_categories
Lists every type of event category supported by the platform.

### list_marketing_events
Returns a full list of all marketing events managed in your account.

### list_syndication_partners
Lists all connected sites and partners within the Evvnt syndication network.

### list_draft_marketing_events
Finds all marketing events that are currently in a 'Draft' or 'Pending' status.

### list_successfully_distributed_events
Identifies which events have completed distribution across the partner network.

### list_saved_venues
Lists all physical venues and locations you have saved to your profile.

## Prompt Examples

**Prompt:** 
```
List all active event marketing campaigns.
```

**Response:** 
```
I've found 5 active campaigns, including 'Summer Jazz Festival' and 'Tech Innovation Workshop'. Both are currently 'Published' and distributed to the network. Would you like to see the distribution report for the Jazz Festival?
```

**Prompt:** 
```
Show me the distribution report for event ID '12345'.
```

**Response:** 
```
For event ID '12345', I've retrieved the report: 450 total sites reached, 1,230 clicks generated, and active syndication on top partner sites. Should I pull the geographic reach summary?
```

**Prompt:** 
```
Check saved venues in our account.
```

**Response:** 
```
You have 12 saved venues, including 'The Grand Theater', 'City Convention Center', and 'Downtown Gallery'. All profiles are active. Would you like the contact details for The Grand Theater?
```

## Capabilities

### Audit overall account health
Get a high-level summary of event volume, distribution success rates, and your organizational account limits.

### Manage event listings
List all promoted marketing events or pull detailed information about one specific event's settings and categories.

### Track performance reports
Retrieve full distribution metrics for any single event, including total sites reached and accumulated clicks.

### Inspect the partner network
Access and list all connected syndication partners and saved venue profiles in your account.

### Identify pending campaigns
Filter and retrieve a list of marketing events that are currently marked as 'Draft' or 'Pending' for review.

## Use Cases

### Post-Campaign Performance Review
The Marketing Manager needs to know if the 'Tech Summit' campaign hit its goals. They ask, 'What are the distribution reports for Tech Summit?' Your agent runs `get_event_distribution_reports` and immediately replies: 450 total sites reached, 1,230 clicks generated. The data is ready for a stakeholder meeting.

### Pre-Launch Content Check
The Operations Coordinator needs to make sure no important event was forgotten. They ask the agent to check `list_draft_marketing_events`. The agent replies, listing three campaigns that are stuck in 'Pending' status and need manual approval.

### Network Audit
The Content Strategist needs to vet potential new locations. They ask the agent to check `list_saved_venues`. The agent provides a list of all 12 saved venues, confirming which ones are active and ready for promotion.

### Quick Status Check
The Event Marketer is on the move. Instead of logging into a portal to check overall health, they ask for a quick audit. The agent runs `quick_event_marketing_audit` and provides an instant summary of campaign volume and distribution success.

## Benefits

- Stop manually checking distribution dashboards. With `get_event_distribution_reports`, your agent pulls real-time performance data—total sites reached and clicks—in a single chat response.
- Keep track of what needs work. Use `list_draft_marketing_events` to immediately identify all events sitting in 'Draft' or 'Pending' status, flagging items that need review before launch.
- Never lose context on your network. Your agent can use `list_syndication_partners` and `list_saved_venues` to give you a complete overview of who is seeing your content and where.
- Get a fast pulse check on operations using `quick_event_marketing_audit`. It gives you an instant, high-level summary of overall event volume and distribution health without running multiple queries.
- Know what's ready to go. Use `list_successfully_distributed_events` to confirm which campaigns have completed their rollout across the entire partner network.

## How It Works

The bottom line is that your AI client handles all the API calls; you just talk to it.

1. Connect the Evvnt integration to your AI client and authorize it using your specific Evvnt Partner API Key.
2. Ask your agent a direct question, like 'Show me the distribution report for Event X.'
3. The MCP executes the necessary tool call, retrieving structured data (like reach metrics or venue lists) which your agent then presents to you in plain text.

## Frequently Asked Questions

**How do I see if an event was successfully distributed using `list_successfully_distributed_events`?**
Calling `list_successfully_distributed_events` returns a list of IDs for campaigns that have completed their rollout across the partner network. This confirms they passed the active distribution stage.

**What is the difference between listing all events and using `list_marketing_events`?**
`list_marketing_events` provides a comprehensive list of everything managed in your account. It's the starting point before you want to dive into detailed status or reports for specific items.

**Can I check my API usage limits with `get_evvnt_account_metadata`?**
Yes, calling `get_evvnt_account_metadata` retrieves the general operational metadata and current limits for your Evvnt account. It's a good step to take before running large reports.

**Do I need multiple tools to get a full distribution report?**
No, you typically don't. Using `get_event_distribution_reports` pulls the performance data for one event in a single action, making cross-referencing unnecessary.

**How do I find out what types of events are supported in the Evvnt system using `list_event_categories`?**
It provides a comprehensive list of all valid event categories. Run this tool first to confirm the correct naming conventions before setting up any new listings or checking detailed data.

**If I need performance reports for multiple events, is it best practice to use `list_marketing_events` followed by running `get_event_distribution_reports`?**
Yes, that's the most efficient workflow. First, retrieve a list of all event IDs using this MCP tool. Then, loop through those IDs to generate individual reports for each campaign.

**What information does `list_syndication_partners` provide about my network reach?**
This tool lists every partner site and syndication location connected to the Evvnt network. You can use this data to verify which sites are currently receiving your event listings.

**If I run `get_event_detailed_data` with an event ID that doesn't exist, what should I expect?**
The MCP returns a specific 'Not Found' error code. This confirms the ID is wrong or the account hasn't been properly linked to that campaign yet.

**How do I get an Evvnt API Key?**
Log in to your Evvnt partner dashboard, navigate to **Account > API**, and you can generate or retrieve your unique **Partner API Token** from there. API access is typically provided to authorized partners.

**Does the integration show clicks per site?**
Yes, you can use the get_event_distribution_reports tool to retrieve detailed telemetry, including total site count and engagement metrics for specific events.

**Can the agent submit new events?**
This integration currently focuses on listing and auditing promoted events and reports. Submitting new events for syndication should be managed via the Evvnt submission interface or automated ingestion partner tools.