# Fibery MCP

> Fibery MCP connects your entire work management workspace to your AI agent. It lets you read schemas, query data across all custom databases, create new tasks, and add status updates—all through natural conversation. Stop navigating menus; start asking questions about your project data.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, workflow-automation, schema-management, collaboration, database-query

## Description

This MCP gives your agent direct access to the heart of your Fibery workspace. You don't have to jump into the portal and click around just to find a piece of information or update a status. Instead, you talk to your AI client, and it handles the complex database interactions for you.

Need to know what’s going on with Product X? Your agent can pull structured data from specific databases, search across every app in your workspace, and even tell you exactly who needs to review something by listing all users. You can ask your agent to update a task status or add a comment directly to an entity record without ever leaving your chat window. If you're looking for robust ways to handle custom workflows from different clients, Vinkius hosts this MCP, ensuring deep compatibility with any AI agent.

This means software teams can sync development progress and product managers can gather insights simply by asking questions in plain English.

## Tools

### add_comment
Posts a new comment onto an existing project record (entity).

### create_entity
Builds and saves a brand-new item into any specified database.

### delete_entity
Permanently removes an existing project record (entity).

### get_comments
Retrieves all comments posted to a specific record, letting you see the full history.

### get_entity
Fetches all data for one specific item using its unique ID.

### get_schema
Retrieves a blueprint of your entire workspace, showing every available database and field type.

### list_apps
Lists all the main functional areas (spaces) used in your Fibery account.

### list_users
Shows a list of every user who has access to your workspace.

### query_entities
Searches and pulls data from specific databases using detailed filters you provide.

### search_entities
Looks for information across every single database in your workspace using keywords.

### update_entity
Changes the data (like status or assignee) on an existing record.

## Prompt Examples

**Prompt:** 
```
List all active spaces in my Fibery account.
```

**Response:** 
```
I've retrieved your spaces. You have 'Product Management', 'Software Development', and 'Marketing Operations' active. Which one would you like to explore further?
```

**Prompt:** 
```
Show me the tasks assigned to me in the 'Software Development' space.
```

**Response:** 
```
Inspecting entities... I found 5 tasks assigned to you, including 'Fix Bug #102' and 'Implement API caching'. Would you like the full details for any of these?
```

**Prompt:** 
```
Add a comment to task UUID-123 saying 'The client approved the design'.
```

**Response:** 
```
Comment added successfully! Your message has been posted to the task and your team has been notified flawlessly.
```

## Capabilities

### Discover workspace structure
Retrieve a map of all your apps, databases, and custom fields so the agent knows where to look.

### Read specific record data
Pull details for any single item (entity) using its unique ID or by searching keywords across multiple databases.

### Write and change records
Create, modify, or delete entire records in custom databases based on your instructions.

### Manage team communication
Read the conversation history or add a new comment to any project record.

## Use Cases

### The QA Team needs to check all related tickets.
Instead of opening the 'Software Development' space and manually cross-referencing multiple databases for bug reports, the agent uses `search_entities` with keywords like 'API failure' across all spaces. It compiles a single list of affected records instantly.

### The Product Manager needs to check user permissions.
The PM can ask their agent for a list of users and then specifically request details on who has access, using `list_users` to verify team membership before onboarding new contractors.

### A developer finished the feature and needs to signal completion.
The dev doesn't need to click through multiple dropdown menus. They simply ask their agent to 'Mark this entity as complete and assign it to QA.' The agent runs `update_entity` using the appropriate record ID.

### A stakeholder needs a summary of all active projects.
The agent can run `list_apps` first, giving the stakeholder an overview of all functional areas. Then, it uses `query_entities` to pull key metrics (like 'Last Updated Date' and 'Status') from each app into one readable report.

## Benefits

- Stop navigating menus. Instead of opening multiple tabs to gather data from different project spaces, you simply ask your agent for the information. The agent handles the cross-database lookup automatically.
- You can automate status changes instantly. If a bug is fixed and ready for QA, tell your agent instead of finding the card, clicking 'Status,' and selecting 'Ready.' Use `update_entity` to change it directly.
- Keep team context alive. Need to know what was decided last week? Your agent can use `get_comments` to pull the conversation history attached to any record, so you never lose critical decisions in a thread.
- Build custom reporting without SQL. Instead of exporting data and running joins in a spreadsheet, use `query_entities` to pull exactly the structured data set you need and get it back immediately for analysis.
- Centralize knowledge. If you're unsure which databases exist or what fields they hold, let your agent run `get_schema`. It gives you a full map of everything available in your workspace.

## How It Works

The bottom line is, once connected, your AI agent treats Fibery like a single data source you can talk to.

1. Subscribe to this MCP and provide your Fibery workspace name along with an API token.
2. Connect your preferred AI client (like Claude, Cursor, or Windsurf) through the Vinkius catalog.
3. Instruct your agent on what you need—for example, 'Find all tasks assigned to me in Marketing Operations that haven't been updated this week.'

## Frequently Asked Questions

**How does Fibery MCP handle cross-database searches?**
The agent runs `search_entities`, which looks for keywords across every single database type (or 'app') in your workspace. It doesn't just check one area.

**Can I use Fibery MCP to update an entity status?**
Yes, you can. Using `update_entity`, the agent changes any field on a record, such as moving a task from 'In Progress' to 'Review.' You just need the specific item ID.

**What is the best way to get an overview of my workspace?**
Run `list_apps` first. This gives you a list of all major spaces, and then you can use `get_schema` for details on what data lives inside each one.

**Does Fibery MCP only work with tasks?**
No, it works with any structured 'entity.' You're not limited to task management; you can manage custom databases—like lists of vendors or required equipment—too.