# HiDeliver MCP

> HiDeliver lets you manage entire email list campaigns and broadcast messages directly through your AI chat. Check subscriber lists, pull campaign stats, or add new contacts without ever leaving your conversation window.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** bulk-email, subscriber-management, email-delivery, campaign-insights, list-segmentation, marketing-broadcasts

## Description

Tired of jumping between your marketing platform, your CRM, and a spreadsheet just to send an email? This MCP connects the full HiDeliver suite straight into any compatible agent. You can ask your AI client to check specific list segments—for instance, verifying if a key lead is already in your database—or pull live performance metrics on recent campaigns. Need to add new subscribers? Your agent handles that too. It's all about keeping your marketing flow going without context switching. When you connect this MCP via Vinkius, the entire HiDeliver catalog becomes available through conversation, letting you perform complex tasks like scheduling broadcasts or reviewing account health using nothing but natural language.

## Tools

### cancel_delivery
Marks a scheduled delivery trace as canceled.

### create_delivery
Schedules and logs a new physical pickup delivery request.

### get_account_balance
Checks the number of available tokens or remaining account credit.

### get_delivery
Fetches all details related to a specific delivery ID.

### get_profile
Retrieves general information about the authenticated HiDeliver account.

### get_transaction
Isolates and views details for a single financial API transaction.

### list_deliveries
Gets a list of all currently active or scheduled delivery requests.

### list_transactions
Retrieves the global history of ledger events and financial activity.

### update_delivery
Makes changes to parameters on an existing delivery route or schedule.

## Prompt Examples

**Prompt:** 
```
Display all the actively loaded marketing lists right now.
```

**Response:** 
```
Connecting... I found currently 3 deployed lists on your marketing gateway block. Let me show you the primary fields.
```

**Prompt:** 
```
Fetch the underlying metadata and info associated with list ID 55102.
```

**Response:** 
```
I received all configured limits concerning that base block. Notice its double opt-in flag stands enforced against cold drops.
```

**Prompt:** 
```
Add the new email address 'lead@example.com' to list 55301.
```

**Response:** 
```
Done! Subscriber successfully securely injected into list 55301 matching the platform parameters.
```

## Capabilities

### Audit and Manage Subscriber Lists
Get a full view of your stored customer addresses and inspect the metadata for existing list segments.

### View Campaign Performance Data
Pull real-time statistics on broadcast performance, including delivery metrics and overall campaign health.

### Add or Modify Contacts
Inject new email addresses into specific lists or update existing records within your subscriber database.

### Check Account Health and Billing
Review remaining marketing tokens, check the account balance, or isolate past transactions for auditing purposes.

### Manage Deliverable Records
Handle specific delivery logs, such as scheduling a new pickup record or adjusting parameters on an active route.

## Use Cases

### Lead Qualification Check
An SDR finds a hot lead's email address but isn't sure if they are already in the database. Instead of asking a colleague, they ask their agent to check the list status using the tool that gets profile data, confirming if the lead is verified and ready for outreach.

### Post-Campaign Audit
A Marketing Manager just sent out a major product announcement. They immediately prompt their agent to pull real-time delivery performance lists, getting instant stats on open rates and bounces without leaving the chat window.

### List Hygiene Maintenance
An Agency Developer needs to ensure their campaign rules work correctly for a small subset of contacts. They use the agent to fetch underlying metadata for specific list IDs, validating double opt-in flags before launching a large broadcast.

### Billing Verification
The Marketing Manager notices a high cost on their account and needs proof of recent activity. They ask the agent to run `list_transactions` immediately to view the global ledger events, confirming what charges occurred today.

## Benefits

- No more jumping apps. You manage list segmentation, checking metadata or adding new subscribers, all within a single conversation with your agent.
- Instant campaign validation. Pull real-time broadcast statistics without logging into the HiDeliver dashboard just to see if the last send worked.
- Maintain account integrity on the fly. Use `get_account_balance` and `list_transactions` to audit spending or check token limits before sending a mass email.
- Granular control over data flow. Need to confirm a lead's status? The agent handles fetching details, allowing you to verify if they are safe in your lists.
- Future-proof workflows. Agency developers can use this MCP to construct custom mailing flows and test dispatch rules directly via API calls.

## How It Works

The bottom line is you talk to your marketing system using plain English prompts instead of navigating complex web UIs.

1. Subscribe to this MCP endpoint and provide your core HiDeliver API key string.
2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius catalog.
3. Ask your agent a question—for example, 'What are my top three active subscriber lists?'—and let it handle the rest.

## Frequently Asked Questions

**How do I get started?**
Subscribe, copy your active API Key (which you can generate inside **HiDeliver Portal → Security/Dev Settings**), and connect it. The integration expects standard raw API connections so you interact intuitively through words instead of intricate data schemas.

**Can it query active subscriber details globally?**
Yes! Direct your AI agent to query list nodes or fetch the comprehensive subscriber logs. The `list_subscribers` action aggregates arrays of real, valid accounts securely for your reporting needs in an instant.

**What happens when I want to fetch metrics or fields for one target list?**
Provide the exact List ID. The tool evaluates endpoint rules (`get_list`) and unpacks default configuration details (such as names, double-opt rules, and associated status) natively to the terminal.

**Can my AI automatically create or append specific subscriber profiles?**
Absolutely. Pass specific parameters, including the new email, name, and respective list ID. The system validates the JSON schema instantly with the `create_subscriber` pipeline effectively logging campaigns on the fly.

**How do I verify my current HiDeliver account credentials using get_profile?**
Calling `get_profile` pulls your live, authenticated account logic. This confirms your connection status and retrieves essential details about your managed account settings.

**If a scheduled broadcast needs changes or cancellation, how do I use update_delivery or cancel_delivery?**
You can manage sends by first checking active routes with `get_delivery`, then using `update_delivery` to adjust parameters. If the send fails or is no longer needed, `cancel_delivery` stops the mapped delivery trace immediately.

**How do I check my remaining message capacity with the get_account_balance tool?**
`get_account_balance` evaluates your current token or cash threshold. This quick check ensures you don't attempt broadcasts when your account runs low on sending credits.

**Can I use list_deliveries to review a history of scheduled or failed sends?**
`list_deliveries` retrieves all active and past delivery requests. This allows you to audit the status, timing, and parameters for any send job executed through your MCP.