# AiMasher MCP

> AiMasher MCP lets you manage your entire marketing content lifecycle from one place. It handles campaign orchestration, template management, and high-volume article blueprint generation using natural language commands. This is your dedicated engine for automated content creation and publishing workflow control.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** aimasher, content-rewriting-api, article-blueprinting-tools, autoblogging-orchestration, rss-marketing-automation, content-strategy-tools, content-management, ai-writing-automation, mcp

## Description

This MCP lets your AI client take over the messy parts of content strategy. Instead of juggling multiple dashboards to track what's being written or when it needs review, you coordinate everything through conversation. You can programmatically list all running campaigns, grab details on specific article templates, and monitor publishing rules in real-time. Need to know which source URL was used for a piece? You retrieve the author metadata directly. It’s built for speed: check API connectivity status or query campaign volumes instantly. When you connect this MCP via Vinkius, your AI acts like an automated content coordinator, handling everything from initial blueprinting to final result tracking.

## Tools

### check_aimasher_status
Verifies the current API connectivity status of the AiMasher account.

### create_campaign
Creates a new content campaign, optionally assigning it to a specific template.

### generate_content
Generates content for an existing campaign by passing a custom prompt.

### get_account
Retrieves high-level account information, including usage metrics and status data.

### get_campaign
Pulls detailed metadata for a single, specified content campaign.

### get_template
Retrieves specific details about an article rewriting template.

### list_campaigns
Lists every active and archived AI content campaign managed by the account.

### list_outputs
Provides a list of all generated outputs resulting from completed campaigns.

### list_results
Retrieves a comprehensive list of all content generation results over time.

### list_templates
Lists every available article rewriting template defined in the account.

## Prompt Examples

**Prompt:** 
```
List all active campaigns in my AiMasher account.
```

**Response:** 
```
I've retrieved your campaigns. You currently have 5 active profiles, including 'Daily Tech Feed' and 'Marketing Blueprint'. Would you like the detailed platform metadata for any of them?
```

**Prompt:** 
```
Show my article rewriting templates.
```

**Response:** 
```
Template architecture orchestrated! I've identified 3 rewriting templates, including 'Professional Tone' and 'Creative Spin'. I've retrieved the technical metadata for your review. Need help selecting a template for your next campaign?
```

**Prompt:** 
```
Check the status of my latest article blueprints.
```

**Response:** 
```
Blueprint intelligence orchestrated! I've identified 10 article blueprints processed today. All are ready for your final publishing rules. Your API connection is healthy. Shall I retrieve the detailed word count metadata?
```

## Capabilities

### Monitor System Health
Verify the connection status and query volume limits of the AiMasher platform.

### Manage Campaigns
Create new content campaigns or retrieve detailed metadata for existing ones.

### Generate Content Blueprints
Run a campaign using custom prompts to generate structured marketing assets and articles.

### Retrieve Templates
List all available article rewriting templates or pull specific template details for use in campaigns.

### Track Outputs
View lists of generated campaign outputs and historical results to track content history.

## Use Cases

### Need a full content audit?
The marketing lead needs to know every campaign that ran last quarter. They ask their agent to call `list_campaigns` and then run `list_outputs`. The agent compiles the detailed platform metadata, giving them an instant, auditable report without needing multiple exports.

### Launching a new product line?
The content team needs to ensure all articles follow the 'Professional Tone' template. They use `list_templates` to confirm the template exists, then use `create_campaign` and `generate_content` together, ensuring every piece is styled correctly from the start.

### Debugging a broken pipeline?
The developer notices content generation failed. They first check `check_aimasher_status` to rule out API issues. If connectivity is fine, they use `get_account` to verify their current query volume and scale up if necessary.

### Archiving old work?
A site owner wants a complete record of all content ever generated for compliance. They ask the agent to run `list_results`, getting a single, chronological list that includes source URLs and author metadata for every piece.

## Benefits

- Automate campaign setup. Use `create_campaign` to programmatically list or start new content initiatives, saving the manual steps of filling out forms across multiple tabs.
- Maintain consistency with templates. By running `list_templates`, you can verify your custom rewriting templates are available and properly structured before generating any material.
- Track everything in one place. Instead of checking dashboards for finished pieces, use `list_results` to get a clean record of all generated content over time.
- Manage the whole process fluidly. You don't need to jump between tabs; your agent can pull detailed campaign metadata using `get_campaign` and structure it instantly.
- Scale confidently. Use `check_aimasher_status` to verify API connectivity and monitor query volume so you never hit an unexpected usage limit when running large jobs.

## How It Works

The bottom line is you don’t have to manually copy anything. Your AI handles the coordination of content growth across all these tools.

1. First, subscribe to this MCP on Vinkius and retrieve your dedicated API Key from the AiMasher dashboard. The required input is that key.
2. Next, tell your AI client what you need—for instance, 'List all active content campaigns' or 'Generate a new campaign for Q3 product launch'.
3. Your agent executes the necessary calls, returning structured data like detailed platform metadata and generated article blueprints ready for review.

## Frequently Asked Questions

**How do I check my API usage with AiMasher MCP?**
Run `check_aimasher_status`. This tool verifies your account's connectivity and gives you the current query volume metrics, which is crucial for scaling.

**Can I see all my content templates using list_templates?**
Yes. Use `list_templates` to get a full list of every rewriting template available in your account. You can then use the specific name with `get_template` for details.

**What if I want to start a new campaign?**
You should call `create_campaign`. This initiates a new project and lets you optionally assign it a template right away, which saves steps later on.

**How do I get the final results after generation?**
Use `list_results` to retrieve a comprehensive list of all generated content outputs over time. This tool provides a historical view you can audit easily.

**How do I confirm my API credentials and usage limits using get_account?**
This function confirms your account's status. It retrieves core account information, including your active plan details and current consumption metrics. This is the best way to verify connectivity before running heavy jobs.

**If content generation seems stuck or incomplete, what should I check using list_outputs?**
The list_outputs tool tracks the status of all generated blueprints. It shows if a job is pending, failed, or complete. You can pinpoint exactly which piece needs attention without guessing.

**How do I ensure my content meets a specific style guide when I use generate_content?**
You must pass either a custom prompt or an existing template ID to the tool. This gives the AI agent enough guardrails, ensuring the output adheres to your required tone and structure.

**I need to modify my content strategy; how do I view the architecture of a specific rule using get_template?**
Using get_template retrieves the full technical metadata for any stored writing template. This lets you review the underlying rules and parameters before making adjustments.

**How do I find my AiMasher API Key?**
Log in to your account, click on your email address in the upper-right corner, and select **Get API Key** from the dropdown menu.

**Can I retrieve rewriting templates via AI?**
Yes! The `list_templates` tool allows your agent to retrieve metadata for all your custom article blueprints.

**How do I list my active campaigns?**
Use the `list_campaigns` tool to retrieve your complete directory along with the unique identifiers for all managed workstreams.