# Flotiq MCP Connector MCP

> Flotiq connects your AI client directly to your headless CMS, giving you command over structured content and media assets. You can manage everything—from creating new articles to auditing schema types and checking usage limits—all through natural conversation. Stop navigating complex dashboards; start talking to your content source.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** api-first, structured-content, media-asset-management, schema-auditing, content-delivery, rest-api

## Description

Managing a modern website means dealing with thousands of small data points: article drafts, product schemas, image sizes, and content type definitions. Used to require jumping between the CMS interface, developer tools, and separate quota dashboard. Now, you can just talk to your AI agent. This MCP lets you treat your entire structured content source like a single database conversation. Need to see what fields a 'product' needs? Just ask for the schema structure. Want to find every piece of content mentioning 'Q2 earnings'? You search globally and get the IDs instantly. If something is wrong, you can tell your agent to wipe out that specific record or update it with new data. It’s about treating complex backend systems as simple conversational tools. Because Vinkius hosts this MCP, you connect once from any compatible client—Claude, Cursor, Windsurf—and get full access to all the content operations your business needs.

## Tools

### create_cms_object
Write a new, structured piece of content into the CMS.

### wipe_cms_object
Permanently delete a specific node or record from the database.

### get_content_details
Retrieve full details for any content object using its ID.

### get_content_type_schema
Find out the exact structure and fields required by a specific type of content.

### get_tenant_limits
Check your account's current usage against defined limits, like API calls or storage space.

### list_content_objects
List all available content objects of a specific type within the CMS.

### list_media_assets
Get a list and properties of media assets stored in your tenant environment.

### list_all_content_types
List every type of structured content defined in the CMS.

### search_global_content
Search across all available content for specific keywords or phrases.

### patch_cms_object
Update existing fields on a content object safely without overwriting the whole record.

## Prompt Examples

**Prompt:** 
```
List all items of content type 'blogpost'
```

**Response:** 
```
Retrieving blogposts... I found 12 objects including 'Intro to MCP' (ID: 1) and 'AI Workflows' (ID: 2). I can retrieve the full hydrated details for any of these records.
```

**Prompt:** 
```
Show me the JSON schema for content type 'product'
```

**Response:** 
```
Retrieving schema for 'product'... This type includes fields: 'name' (string), 'price' (number), 'description' (richtext), and 'image' (datasource). I can use this structure to help you create new product objects.
```

**Prompt:** 
```
Search global content for 'feature launch'
```

**Response:** 
```
Searching global content... I found 3 matches including a 'blogpost' titled 'March Feature Update' and a 'newsletter' entry. Would you like the IDs or snippets for these matches?
```

## Capabilities

### Content Creation and Modification
Write new articles or update existing records by sending structured data directly into the CMS.

### Structural Validation and Auditing
Retrieve the exact field definitions for any content type to verify if your data structure is correct.

### Global Content Retrieval
Search across all published content types simultaneously, finding articles or pages based on keywords.

### Asset and Limit Monitoring
Check current usage quotas for media assets and identify the specific limits of your account.

### Content Deletion
Permanently delete content records or nodes that are no longer needed in the system.

## Use Cases

### Debugging an API failure
A developer finds a bug when trying to map content data. Instead of manually checking the console, they ask their agent to run `get_content_type_schema` for 'product' and confirm that the required fields—like SKU or weight—are actually available in the CMS structure.

### Mass Content Update
A marketing team needs to change a small piece of text across 50 different articles. They ask their agent to `list_content_objects` by type, gather all the IDs, and then use `patch_cms_object` to update the specific field for every record.

### Global Content Audit
A product team needs to know if there are any old blog posts that haven't been updated in six months. They run a query using `search_global_content` and get the list of IDs, allowing them to audit the entire content library rapidly.

### Preparing for Migration
Before migrating data, you need to know exactly what resources are available. You ask your agent to `list_media_assets` and also check `get_tenant_limits` to calculate how many images and how much storage space you'll actually be moving.

## Benefits

- You can manage entire content objects and media assets without ever opening the Flotiq editor UI. Simply ask your agent to create or update a record using `create_cms_object` or `patch_cms_object`.
- Stop guessing what data fields are available. Use `get_content_type_schema` to pull up the exact structure for any content type, letting you build reliable workflows in your IDE.
- Checking quotas used to mean logging into a separate dashboard. Now, just ask for limits and use `get_tenant_limits` to confirm if you're about to run out of API calls or storage space.
- When you need to find something across the entire site—not just one section—use `search_global_content`. It handles deep searches better than basic database queries.
- Need to delete a piece of content that is broken? Instead of clicking through menus, tell your agent to run `wipe_cms_object`, confirming deletion immediately.

## How It Works

The bottom line is that you send natural language commands, and the MCP translates them into structured API calls against Flotiq's backend.

1. Subscribe to this MCP and plug in your Flotiq API Key, which you find in your Flotiq Dashboard.
2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius catalog.
3. Ask your agent a question like, 'List all content objects of type blog post,' and it handles the rest.

## Frequently Asked Questions

**Can Flotiq MCP handle content types I haven't used before?**
Yes. You can use `list_all_content_types` to see every defined type, and then use `get_content_type_schema` on any of them to understand their structure.

**Is Flotiq MCP only for reading data?**
No. It handles both reads and writes. You can create new content using `create_cms_object`, update existing ones with `patch_cms_object`, or delete records entirely.

**What should I check first when connecting Flotiq MCP?**
You should start by calling `get_tenant_limits`. This ensures you know your current quotas and how much room you have to work with before running any big operations.

**How do I search for content across multiple types using Flotiq MCP?**
Use the `search_global_content` tool. This allows agents to query all available content sources simultaneously, rather than limiting your search to just one type.

**If I need to debug an API endpoint, which Flotiq MCP tool should I use?**
Use `get_content_type_schema`. This function provides the precise structure of data blocks, letting you confirm if your code expects fields that actually exist in the CMS.