# Drupal MCP for AI Agents AI Agent Connect

> Drupal MCP. Manage headless content, handle taxonomy terms, and audit users directly from any AI agent. Connect your Drupal site to your AI client to handle content workflows without switching tabs.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_khl0nMsaToaE4vm7MyYoAmLbSdZZMzMdhxvwKGVC/ai-agent-connect
- **Tags:** json-api, node-management, taxonomy, entity-framework, web-development, content-orchestration

## Description

This Drupal MCP lets you manage your headless content without the usual headache of clicking through the admin dashboard. Instead of hunting for the right button to update a node or category, you can just tell your agent what to do. It handles the backend calls in the background so you can focus on the actual work of creating and organizing content. You can push new nodes, swap out draft text on existing ones, or audit your user list in seconds. It's a much faster way to keep your site updated, and you'll find that having this in your Vinkius catalog makes it a lot easier to keep your headless CMS in sync with your daily workflow. You get a direct line to your data, which means fewer mistakes and way less time spent on repetitive data entry.

## Tools

### get_taxonomy_term
Extract properties that drive active Term mappings. This helps you understand how your categories are structured.

### list_managed_files
Inspect internal arrays to find specific picture constraints. Use this to see all the files currently managed by the system.

### list_content_nodes
Identify bounded routing spaces inside your Headless Drupal models. This shows you all the content currently live on your site.

### list_term_vocabularies
Enumerate and export structured rules for your Taxonomies. This gives you a full list of your content categories.

### list_drupal_users
Identify active arrays of rented Admin identities. Use this to see every user who currently has access to your site.

### patch_cms_node
Substitute draft values safely to replace specific row segments. This allows you to update one part of a node without touching the rest.

### wipe_cms_node
Use this to permanently delete specific nodes from your site. It helps you clear out old document entities quickly without manual deletion.

### get_file_metadata
Fetch the exact structural matching to verify where files are stored. This is useful for checking your CDN URIs.

### get_single_node
Retrieve cloud logging traces for specific Node UUIDs. Use this to find the exact data for a single piece of content.

### create_cms_node
Provision JSON payloads to write new rows into Drupal entities. Use this to create new content nodes using plain text.

## Prompt Examples

**Prompt:** 
```
List the last 5 articles from my Drupal site.
```

**Response:** 
```
Retrieving your recent articles... I found the following 5 nodes:

| Title | UUID |
| :--- | :--- |
| Welcome to Headless Drupal | 123 |
| JSON:API Basics | 456 |
| Summer Sale | 789 |
| New Policy Update | 101 |
| Contact Us | 102 |

Would you like me to fetch the full content for any of these?
```

**Prompt:** 
```
Create a new post called 'Summer Sale' with the body 'Sale starts now'.
```

**Response:** 
```
Node created successfully! Your new article 'Summer Sale' has been persisted in Drupal with UUID: 'abc-789'. You can now view it in your frontend or admin UI.
```

**Prompt:** 
```
Who are our current admin users?
```

**Response:** 
```
I've retrieved the list of active admin identities:

* **Admin_User_1** (Role: Administrator)
* **Editor_Jane** (Role: Content Editor)
* **Ops_Bob** (Role: Site Manager)

Would you like to see more metadata for any of these users?
```

## Capabilities

### Create new content nodes
Add new items to your site by providing a title and body in plain text.

### Update existing content
Change specific parts of a draft or live node without overwriting the whole thing.

### Delete old nodes
Remove specific document entities from your database instantly.

### Manage taxonomy terms
List and organize your categories and labels to keep content sorted.

### Audit user accounts
See a list of active admin identities and their roles for security checks.

### Retrieve file metadata
Check the storage details and URIs for your managed media assets.

## Use Cases

### Bulk Content Updates
A manager needs to change the status of 10 articles. They ask the agent to use patch_cms_node on a list of specific UUIDs to update them all at once.

### Fast Content Creation
A writer wants to post a new blog entry. They tell the agent to use create_cms_node with the title and body, and the content goes live immediately.

### Security Audits
An admin needs to see who has access to the site. They ask the agent to list_drupal_users to check roles and identities in a simple list.

### Media Verification
A developer needs to see if a specific file is on the CDN. They use get_file_metadata to check the storage details without opening the dashboard.

## Benefits

- Skip the Drupal admin UI by using create_cms_node to push content directly from your chat window.
- Fix errors faster by using patch_cms_node to update specific row segments without overwriting everything.
- Clean up your database with wipe_cms_node to remove old entities instantly.
- Audit your security by using list_drupal_users to see every active admin account at a glance.
- Organize content better by using list_term_vocabularies to see all your taxonomy rules in one place.
- Find assets quickly by using list_managed_files to see your CDN URIs and media constraints.

## How It Works

The bottom line is you get a natural language interface for your headless content.

1. Subscribe to the Drupal MCP and connect it to your AI client.
2. Enter your Drupal Base URL and your Auth Header into the configuration.
3. Ask your agent to create content, update nodes, or audit your user list.

## Frequently Asked Questions

**Can I use the Drupal MCP with my headless setup?**
Yes, it's built specifically for headless sites using the JSON:API module.

**Does the Drupal MCP require me to log into the admin UI?**
No, it bypasses the UI so you can manage content through your AI client.

**Can I use this to update specific parts of a node?**
Yes, you can update specific segments of a node without changing everything else.

**How do I find my files using the Drupal MCP?**
You can list all managed files and see their storage details.

**Is it safe to delete nodes with this Connector?**
Yes, it gives you a direct way to remove specific entities from your database.

**Can I use this to manage my taxonomy terms?**
You can list vocabularies and terms to organize your content categories.

**Does the Drupal MCP work with any AI client?**
It works with any client that supports the Model Context Protocol.

**Can my agent create a new content node in Drupal?**
Yes. Use the 'create_cms_node' tool. Provide the node type (e.g., 'article') and a JSON object with the attributes. The agent will orchestrate the HTTP POST request to your Drupal JSON:API to persist the entity.

**How do I list all taxonomy terms for a specific vocabulary?**
Use the 'list_term_vocabularies' tool. Provide the vocabulary ID (e.g., 'tags'). Your agent will execute bulk iterations to track explicitly registered terms and return them within your chat context.

**Can I retrieve the direct URL for a managed image file?**
Absolutely. Use the 'get_file_metadata' tool with the file ID. The agent will analyze the explicit UUID bounds and fetch the literal URL parameters, providing the public location of the managed attachment.