# Craft CMS (Craftnet) MCP

> Craftnet MCP manages your entire developer lifecycle for Craft CMS. Use this to audit licenses, track sales payouts, manage plugins published on the Craft Store, and access deep account metadata using just natural conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** plugin-management, license-management, software-distribution, cms-ecosystem, sales-tracking

## Description

Managing a large development ecosystem usually means jumping between five different dashboards: one for licensing, one for sales reports, one for plugin listings, and another for user accounts. It's time-consuming and error-prone.

This MCP connects your agent directly to the Craftnet developer services platform. You can ask it questions like, 'Show me all active CMS licenses linked to our agency domain,' or 'What were my top three selling plugins last quarter?' The system runs those queries instantly and presents a clean report. It's basically giving you full API access without forcing you to write any code.

When your agent talks to this MCP, it handles the complexity of listing plugin details, auditing license status, or checking historical payouts—all within one chat window. You connect this powerful capability through Vinkius and get immediate access to managing your entire CMS development pipeline.

## Tools

### get_account_details
Retrieves basic metadata about your Craftnet developer account.

### get_plugin_details
Pulls specific information for one plugin using its unique identifier.

### list_plugin_categories
Retrieves all available plugin categories on the Craft Store.

### list_cms_licenses
Retrieves a list of every Craft CMS license registered to your account.

### list_payout_history
Generates a list of historical payment payouts for your published plugins.

### list_plugin_licenses
Lists every individual plugin license that has been purchased or managed.

### list_plugins
Provides a complete list of all plugins published on the Craftnet marketplace.

### list_sales_history
Gathers records detailing recent sales transactions for your developer profile.

### list_craftnet_users
Lists all developer and admin users associated with the Craftnet account.

### search_plugins_by_name
Searches the Craft Store catalogue using a specified keyword or plugin name.

## Prompt Examples

**Prompt:** 
```
List all Craft CMS licenses in my account.
```

**Response:** 
```
I've found 5 Craft CMS licenses. 3 are currently 'Active' and 2 are 'Expired'. Would you like to see the associated domain names for the active ones?
```

**Prompt:** 
```
Show me my recent plugin sales for this month.
```

**Response:** 
```
This month you've made 12 plugin sales totaling $450. Your most popular plugin was 'SEOmatic'. Should I list the individual transaction details?
```

**Prompt:** 
```
Search for plugins related to 'E-commerce' on Craftnet.
```

**Response:** 
```
I've searched Craftnet and found several e-commerce plugins, including 'Commerce', 'Shopify', and 'Snipcart'. Which one would you like to inspect for details?
```

## Capabilities

### Audit all active licenses
The system lists every Craft CMS and plugin license associated with your developer account.

### Track sales and payouts
You pull up detailed records of recent sales transactions and historical payout data for your plugins.

### Audit the entire plugin catalog
The agent lists every single plugin published on Craftnet, or filters them by category.

### Get account metadata
Retrieve specific details about your core Craftnet developer account settings and users.

## Use Cases

### Client License Audit
A technical lead needs to confirm if a client has paid for the correct tier of CMS and plugins. Instead of running reports in the backend, they ask the agent to `list_cms_licenses`, instantly confirming which licenses are active and expired.

### Quarterly Sales Review
A freelancer wants a summary of their revenue streams. They prompt the agent to review recent sales using `list_sales_history` and follow up by checking payout records with `list_payout_history` to ensure all funds are accounted for.

### Product Expansion Planning
An agency owner needs ideas for new client offerings. They ask the agent to list available categories using `list_plugin_categories`, which helps them identify market gaps and plan their next set of plugins.

### Debugging Plugin Conflicts
A developer suspects a plugin conflict. They use `get_plugin_details` on the suspected plugin, getting deep technical information that they can then compare against other tools to pinpoint the exact issue.

## Benefits

- Stop jumping between dashboards. You can audit all your plugin licenses or check payout history by simply asking the agent a question.
- Get immediate oversight of your entire developer portfolio. Functions like `list_plugins` and `search_plugins_by_name` let you instantly map out what's available on the store.
- Simplify compliance checks. You can run the `list_cms_licenses` tool to verify license status across all client sites without logging into the CMS itself.
- Automate financial reporting. Quickly pull up transaction details using `list_sales_history` and review historical payouts via `list_payout_history` in one go.
- Maintain a single source of truth for your assets. By combining data from `get_account_details` with plugin information, you keep all metadata centralized.

## How It Works

The bottom line is that you get full developer platform functionality through conversation, bypassing manual dashboard navigation entirely.

1. Connect this MCP to your AI client and use your Craftnet API Key for authorization.
2. Ask the agent a natural language question, like 'List all paid licenses.'
3. The agent executes the required function calls and returns structured data summarizing the results.

## Frequently Asked Questions

**How do I get a Craftnet API Key?**
Log in to your Craft ID account at craftcms.com, go to **Settings > API Keys**, and generate a new key. Note that some endpoints require developer permissions.

**Can I manage client licenses via chat?**
Yes, you can list all CMS and plugin licenses associated with your account, helping you audit and track renewals or project-specific assignments.

**Does the integration track plugin sales?**
Yes, if you are a plugin developer, you can list your recent sales history and historical payout data directly through the agent.

**How do I use `get_account_details` to verify my overall Craftnet account metadata?**
It retrieves your high-level developer profile data. You'll find key information here, like your unique ID and core configuration details for the entire account.

**What does the `list_craftnet_users` tool do regarding user management?**
This tool lists every user associated with your developer profile. It helps you track who has access to your services and what their roles are within Craftnet.

**If I use `search_plugins_by_name`, how accurate must my keyword be?**
The tool doesn't require exact matches. If your keyword is partial, it will return related results instead of failing. This helps you narrow down the right plugin easily.

**How can I use `get_plugin_details` to inspect a single plugin thoroughly?**
It pulls comprehensive data for one specific plugin by name or ID. You'll get its version history, compatibility notes, and its primary category.

**Does the `list_plugin_licenses` tool cover every license I manage?**
Yes, it lists all purchased or managed plugin licenses. This scope covers specialized add-ons separately from your main Craft CMS core subscription.