# Zenkit MCP MCP

> Zenkit lets your AI agent interact directly with structured data across multiple workspaces and collections. Use this MCP to programmatically read, write, update, or delete entries in your knowledge base, making it a central hub for managing operational records from any client application.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, workspace-collaboration, data-entry, project-tracking, list-management, database-views

## Description

This connection gives your agent the ability to manage complex project information stored in Zenkit. Instead of opening multiple tabs and manually copying data between different sections, you can ask your agent to perform actions like listing all available workspaces or retrieving specific details about a collection’s structure. You can command it to fetch all existing entries within a list, create new records with defined fields, or modify statuses on old items. If you're building automations that need to manage data across several platforms—say, updating project status in Zenkit after logging a sale in a CRM—you can chain this MCP together with others, running the entire workflow through one AI agent connected via Vinkius. This makes sure your keys pass through our zero-trust proxy and are used only in transit, meaning nothing is ever stored on disk.

## Tools

### create_entry
Builds a brand new data record in a specific list, requiring you to provide the field values for that item.

### delete_entry
Permanently removes an existing record from your specified Zenkit list.

### get_list_details
Retrieves the full metadata and structure definition for a specific Zenkit collection.

### get_workspace_details
Fetches detailed information about a single workspace within your account.

### list_elements
Shows all the defined fields (columns) that make up a specific list's data structure.

### list_entries
Provides a summary view of every item in a list, often with filtering capabilities.

### list_workspaces
Lists all the main workspaces you have access to and which lists belong inside them.

### update_entry
Modifies one or more fields on a record that already exists in your Zenkit list.

## Prompt Examples

**Prompt:** 
```
List all my Zenkit workspaces and their collections.
```

**Response:** 
```
I've retrieved your workspaces. You have 3 workspaces: 'Marketing', 'Product Development', and 'Personal'. The 'Marketing' workspace contains 2 lists: 'Social Media Calendar' and 'Asset Library'.
```

**Prompt:** 
```
Show me all entries in the list with ID '98765'.
```

**Response:** 
```
I found 15 entries in list 98765. Notable items include 'Review Q2 Budget', 'Update Brand Guidelines', and 'Onboard New Intern'. Would you like to see the details for any of them?
```

**Prompt:** 
```
Create a new entry in list '98765' with name 'Finish API documentation'.
```

**Response:** 
```
Successfully created the entry 'Finish API documentation' in your Zenkit list. The new entry ID is '12345'.
```

## Capabilities

### Browse all knowledge bases
Lists every workspace available to you and shows which lists belong to them.

### Get specific structure details
Retrieves the full configuration, including field types, for a single Zenkit list.

### Fetch all records in a collection
Lists every existing entry (item) within a chosen data list.

### Add new data points
Creates an entirely new record, requiring you to supply the specific field values for that item.

### Modify existing records
Changes one or more fields on a record that already exists in your collection.

### Remove old entries
Deletes a specific entry from a list, keeping the list structure intact.

## Use Cases

### Discovering all project scopes
A PM needs a report showing every active collection across the company. Instead of clicking through five different workspace folders, they prompt their agent: 'List all my Zenkit workspaces and what lists are inside.' The agent uses `list_workspaces` to return the full map instantly.

### Mass updating status records
The marketing team finishes a quarterly review. Instead of manually logging into 3 different list views, they tell their agent: 'Update all entries in the Assets library that are marked 'Draft' to 'Final' and set the owner field to Jane Doe.' The agent uses `update_entry` for bulk changes.

### Building a new structured guide
An HR manager needs a new onboarding list. They prompt: 'Create a new Zenkit collection called 'New Hire Checklist' with fields for Start Date, Manager Email, and Policy Agreement.' The agent handles the setup using `get_list_details` to confirm structure before creating it.

### Auditing historical data
An auditor needs to see all records associated with a specific product line from last year. They ask their agent to 'List all entries in the Product History list filtered by 2023.' The agent uses `list_entries` to provide an immediate, structured audit trail.

## Benefits

- Audit project status instantly. Instead of manually checking multiple dashboards, your agent can use `list_workspaces` to map out every department's current projects.
- Eliminate manual content creation. Need a new record? Use `create_entry` and simply describe the data you want, letting the MCP structure it correctly in Zenkit.
- Keep your knowledge base clean. If an entry is obsolete, use `delete_entry`. Your agent handles the cleanup process via natural language command.
- Maintain data integrity with confidence. You don't have to worry about how keys are handled; Vinkius ensures credentials pass through a zero-trust proxy and never sit on disk.
- Deep dive into structure. Use `list_elements` before updating anything. This lets you inspect the list’s field types, so your agent knows exactly where to write the data.

## How It Works

The bottom line is: you tell your agent what data change needs to happen, and it executes the action directly inside Zenkit.

1. Subscribe to this MCP and input your Zenkit API key.
2. Connect your preferred AI client (Claude, Cursor, etc.) to Vinkius using that single connection.
3. Your agent can then execute commands against the structured data in Zenkit.

## Frequently Asked Questions

**Can I use the zenkit MCP to find out what lists are in a workspace?**
Yes. Use `list_workspaces` first to see all available workspaces. Then, you can drill down using `get_workspace_details` to list the constituent collections within that environment.

**How do I update an entry using the zenkit MCP?**
You must use the `update_entry` tool. Before running it, check the field names by calling `list_elements` to ensure your payload matches the list's defined schema.

**What is the difference between listing entries and getting list details in zenkit?**
The `get_list_details` tool gives you the blueprint—the structure, fields, and configuration of the collection itself. The `list_entries` tool actually retrieves the content—a summary view of all items currently inside that structured container.

**Does zenkit MCP let me create entries for multiple lists?**
You can't do it in a single call, but you can chain calls. You'd use `create_entry` separately for each list and wrap those sequential actions into one agent workflow.

**How do I use `list_elements` to check what fields are available in a specific list?**
It returns the precise data structure of any given list. This lets your agent know exactly which field types and names you can use when creating or updating entries, preventing schema errors.

**What happens if I try to use `create_entry` with incorrect or missing JSON field values?**
The MCP validates the input against the target list's schema first. If any data is invalid or a required field is missing, the call fails and returns an error message detailing exactly what needs correcting.

**Is there any safety check when using the `delete_entry` tool?**
Yes, the agent will prompt you for confirmation before executing a deletion. This built-in safeguard ensures you can't accidentally wipe out important records with a single command.

**Besides listing data, what metadata can I get using `get_workspace_details`?**
This tool provides high-level information about the entire workspace. You retrieve details like list counts and overall configuration settings—perfect for getting a quick structural overview.

**How do I find my List ID?**
Use the `list_workspaces` tool to see all your workspaces and the lists they contain along with their unique IDs.

**Can I filter entries in a list?**
The current `list_entries` tool retrieves all items. For complex filtering, you can provide field-specific values when using the create or update tools.

**Is it possible to see the field definitions of a list?**
Absolutely. Use the `list_elements` tool with a list ID to retrieve all field names, types, and configurations.