Fibery MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'fiberymcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Fibery MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'fiberymcp_get_connectors_list',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "fiberymcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Fibery MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="fiberymcp_get_connectors_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update tab, report, dimension — Updates scalar properties of an existing tab in a Fibery report
• Text set block, replace block — Rewrites the inline content of text blocks from markdown
• Attrs set block — Merges attributes into blocks’ attrs (e.g
• Comment reply document, add — Adds replies to existing inline comment threads in a document
• Tab remove, add table, add metric — Removes a tab from an existing Fibery report
• Dimension remove — Removes a single dimension from a tab in a Fibery report

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

fiberymcp_add_chart_tab#Appends a new chart tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.12 params▾

Appends a new chart tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

reportIdstringrequiredUUID of the report to add the chart tab to (from create_report or get_reports_list).

xarrayrequiredX-axis dimensions. Put categorical/date dimensions before numeric.

yarrayrequiredY-axis dimensions. Put categorical/date dimensions before numeric.

colorobjectoptionalColor-coding (legend) dimension. Only one allowed.

descriptionstringoptionalTab description.

dimensionConditionsarrayoptionalDimension-level filters (must reference expressions already used in the tab).

fieldConditionsarrayoptionalField-level filters applied to this tab's data.

labelarrayoptionalLabel dimensions shown on chart points/bars.

palettestringoptionalColor palette. See get_fibery_skill(skill:'reports') for palette selection guidance.

sizeobjectoptionalSize-coding dimension. Only one allowed.

titlestringoptionalTab title.

typestringoptionalChart type. Defaults to 'scatterplot' if omitted. See get_fibery_skill(skill:'reports') for chart-type guidance.

fiberymcp_add_collection_items#Adds related entities to a Collection field on a Fibery entity.4 params▾

Adds related entities to a Collection field on a Fibery entity.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

fieldstringrequiredThe name of the collection field

itemsarrayrequiredAn array of related entity ids to add to the collection. Each entry must be fibery/id of the entity to add

fiberymcp_add_comment#Adds a top-level comment or reply to an existing comment on a Fibery entity.4 params▾

Adds a top-level comment or reply to an existing comment on a Fibery entity.

NameTypeRequiredDescription

contentstringrequiredComment content in Markdown format

databasestringrequiredFull database name (e.g., 'SoftDev/Task'). Must be a database that supports comments (has the comments/comments collection).

entityIdstringrequiredfibery/id of the entity to comment on

parentCommentIdstringoptionalfibery/id of the parent comment when replying. Omit for a top-level comment. The parent comment must belong to the same entity (entityId) — otherwise the request is rejected.

fiberymcp_add_file_from_url#Attaches a file to a Fibery entity by downloading it from a publicly accessible URL.5 params▾

Attaches a file to a Fibery entity by downloading it from a publicly accessible URL.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

fieldstringrequiredExact name of a file field on this database (e.g., 'Files/Files' or 'Space/Files'). Confirm via `schema_detailed` tool call. Document fields cannot be used.

fileNamestringrequiredName of the file to be added (e.g., 'Report.pdf')

urlstringrequiredHTTP(s) URL to download the file from

fiberymcp_add_inline_comments#Adds inline comments to text inside ONE block. The matched text becomes the highlighted range; block content is NOT changed. The author is the current user. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for more details. For entity-level comments (the Comments field of an entity), use `add_comment` instead. ## Example ``` { secret: "123", comments: [{blockId: "456", exact: "comprehensive test suite", content: "Which suites exactly? Consider linking them."}] } ```2 params▾

Adds inline comments to text inside ONE block. The matched text becomes the highlighted range; block content is NOT changed. The author is the current user. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for more details. For entity-level comments (the Comments field of an entity), use `add_comment` instead. ## Example ``` { secret: "123", comments: [{blockId: "456", exact: "comprehensive test suite", content: "Which suites exactly? Consider linking them."}] } ```

NameTypeRequiredDescription

commentsarrayrequiredComments to attach

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_add_metric_tab#Appends a new metric tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. **Scalar expressions only:** Every metric expression must be a scalar aggregate (e.g. `COUNT([ID])`). Raw field references are not valid here. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.6 params▾

Appends a new metric tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. **Scalar expressions only:** Every metric expression must be a scalar aggregate (e.g. `COUNT([ID])`). Raw field references are not valid here. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

metricsarrayrequiredScalar metrics to display. Each expression must be scalar (e.g. COUNT([ID])). Never duplicate.

reportIdstringrequiredUUID of the report to add the metric tab to (from create_report or get_reports_list).

descriptionstringoptionalTab description.

dimensionConditionsarrayoptionalDimension-level filters (must reference expressions already used in the tab).

fieldConditionsarrayoptionalField-level filters applied to this tab's data.

titlestringoptionalTab title.

fiberymcp_add_table_tab#Appends a new table tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.7 params▾

Appends a new table tab to an existing Fibery report. **Prerequisite:** You need a `reportId` from `create_report` or `get_reports_list`. Call `display_report_schema` first to discover valid field expressions for the report's sources. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

columnsarrayrequiredTable columns. Never duplicate expressions across columns.

reportIdstringrequiredUUID of the report to add the table tab to (from create_report or get_reports_list).

descriptionstringoptionalTab description.

dimensionConditionsarrayoptionalDimension-level filters (must reference expressions already used in the tab).

fieldConditionsarrayoptionalField-level filters applied to this tab's data.

groupByarrayoptionalAdditional group-by dimensions. Do not reuse an expression already used as a column.

titlestringoptionalTab title.

fiberymcp_append_document_content#[STALE: removed upstream, replaced by block-based document tools (insert_document_blocks/set_block_text/read_document)] Appends Markdown content to the end of a document field on a Fibery entity.4 params▾

[STALE: removed upstream, replaced by block-based document tools (insert_document_blocks/set_block_text/read_document)] Appends Markdown content to the end of a document field on a Fibery entity.

NameTypeRequiredDescription

contentstringrequiredDocument's content in MD format. Any content you write here will be APPENDED to already existing content in the document

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

fieldstringrequiredThe name of the document field

fiberymcp_create_avatars_fields#Enables avatar/profile-picture attachments on entities in one or more databases.1 param▾

Enables avatar/profile-picture attachments on entities in one or more databases.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_create_comments_fields#Enables comments on entities in one or more databases.1 param▾

Enables comments on entities in one or more databases.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_create_custom_app#Create a new Fibery custom app, placed in the user's private space unless `spaceName` is provided. This tool does NOT generate any app code — it only creates an empty app scaffolded from the starter template.2 params▾

Create a new Fibery custom app, placed in the user's private space unless `spaceName` is provided. This tool does NOT generate any app code — it only creates an empty app scaffolded from the starter template.

NameTypeRequiredDescription

namestringrequiredName of the new custom app.

spaceNamestringoptionalSpace to place the app view in. Defaults to the user's private space.

fiberymcp_create_custom_app_dev_token#Issue a short-lived (~1 hour) access token for developing a custom app locally. The token authenticates only the app's `get-source-files` / `update-source-files` endpoints, passed as the `custom-app-dev-token` query parameter — see `get_fibery_skill({skill: "custom-apps-dev"})` for the full development loop.1 param▾

Issue a short-lived (~1 hour) access token for developing a custom app locally. The token authenticates only the app's `get-source-files` / `update-source-files` endpoints, passed as the `custom-app-dev-token` query parameter — see `get_fibery_skill({skill: "custom-apps-dev"})` for the full development loop.

NameTypeRequiredDescription

appIdstringrequiredId of the custom app (from get_custom_apps_list or create_custom_app).

fiberymcp_create_databases#Creates one or more new databases within an existing space.1 param▾

Creates one or more new databases within an existing space.

NameTypeRequiredDescription

databasesarrayrequiredNo description.

fiberymcp_create_entities#Creates one or more entities in a Fibery database.2 params▾

Creates one or more entities in a Fibery database.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entitiesarrayrequiredNo description.

fiberymcp_create_files_fields#Creates file attachment fields in one or more databases.1 param▾

Creates file attachment fields in one or more databases.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_create_formula_field#Creates a formula field in a database; the formula expression is generated from a plain-language description.3 params▾

Creates a formula field in a database; the formula expression is generated from a plain-language description.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

descriptionstringrequiredDescription of what the formula should calculate. The formula expression will be generated from this

namestringrequiredName of the formula field in {Space}/{Field} format (e.g., 'SoftDev/Days Since Created'). Space prefix must match the database space

fiberymcp_create_icon_fields#Enables emoji icon fields on entities in one or more databases.1 param▾

Enables emoji icon fields on entities in one or more databases.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_create_multi_select_fields#Creates multi-select fields with predefined options in one or more databases.1 param▾

Creates multi-select fields with predefined options in one or more databases.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_create_primitive_fields#Creates primitive fields (text, number, date, boolean, etc.) in one or more databases.1 param▾

Creates primitive fields (text, number, date, boolean, etc.) in one or more databases.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_create_relation_fields#Creates relation fields between databases, establishing links in both the source and target database.1 param▾

Creates relation fields between databases, establishing links in both the source and target database.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_create_report#Creates a Fibery report with sources and a title. The report is placed in the user's private space unless `spaceName` is provided. Prerequisites: call `schema` to discover valid database names; call `display_report_schema` to discover field expressions before configuring dimensions. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.4 params▾

Creates a Fibery report with sources and a title. The report is placed in the user's private space unless `spaceName` is provided. Prerequisites: call `schema` to discover valid database names; call `display_report_schema` to discover field expressions before configuring dimensions. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

sourcesarrayrequiredOne or more source databases for the report.

titlestringrequiredTitle of the new report.

sourceModestringoptionalSource mode: 'current' (default) queries live entity state; 'historical' resolves a history-timeline source for time-in-state / change-frequency analysis.

spaceNamestringoptionalSpace to place the report in. Defaults to the user's private space.

fiberymcp_create_single_select_fields#Creates single-select fields with predefined options in one or more databases.1 param▾

Creates single-select fields with predefined options in one or more databases.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_create_space#Creates a new space in the Fibery workspace.3 params▾

Creates a new space in the Fibery workspace.

NameTypeRequiredDescription

namestringrequiredSpace name (e.g., "SoftDev")

colorstringoptionalColor for the space (hex color code, e.g., '#FF5722')

descriptionstringoptionalDescription for the space

fiberymcp_create_view#Creates a saved view (grid, board, timeline, calendar, etc.) or standalone document in the Fibery workspace.6 params▾

Creates a saved view (grid, board, timeline, calendar, etc.) or standalone document in the Fibery workspace.

NameTypeRequiredDescription

namestringrequiredName of the view

viewTypestringrequiredgrid: spreadsheet table (supports hierarchical groupBy). list: simple list (prefer grid). board: kanban grouped by relation/enum on x and optionally y. timeline: time bars with optional milestones and dependencies. calendar: date events. map: geographic plot of a location field. feed: rich-text feed of a document field. gallery: card gallery with cover images. gantt: hierarchical timeline with dependencies. form: data input form. document: standalone markdown (use the `content` param). report: not yet supported here.

configobjectoptionalView configuration object. Shape depends on viewType — for anything beyond a basic grid/list with no filters or ordering, call get_tool_reference({toolName: 'create_view'}) first.

contentstringoptionalMarkdown content (for document views)

descriptionstringoptionalShort description of the view in MD format

spacestringoptionalSpace name to create the view in. Pass "Private" to save in Private space. By default, inferred from databases.

fiberymcp_create_workflow_field#Creates a workflow (state) field for tracking entity status through defined stages.3 params▾

Creates a workflow (state) field for tracking entity status through defined stages.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

defaultOptionstringrequiredDefault state name for new entities

optionsarrayrequiredArray of workflow state options

fiberymcp_delete_avatars_fields#Removes avatar fields from one or more databases; restorable via the Activity Log.1 param▾

Removes avatar fields from one or more databases; restorable via the Activity Log.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_delete_comments_fields#Removes comment fields from one or more databases; restorable via the Activity Log.1 param▾

Removes comment fields from one or more databases; restorable via the Activity Log.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_delete_databases#Deletes one or more databases from a space; restorable via the Activity Log.1 param▾

Deletes one or more databases from a space; restorable via the Activity Log.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names to delete (e.g., ["SoftDev/Tasks"])

fiberymcp_delete_document_blocks#Deletes blocks from a document, each with all its children. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model and the editing workflow. Delete a `table` only by the whole `table` block's id — `table_row`, `table_cell` and `table_header` CANNOT be deleted, adding/removing rows or columns is not supported. ## Example ``` { secret: "123", blockIds: ["456", "789"] } ```2 params▾

Deletes blocks from a document, each with all its children. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model and the editing workflow. Delete a `table` only by the whole `table` block's id — `table_row`, `table_cell` and `table_header` CANNOT be deleted, adding/removing rows or columns is not supported. ## Example ``` { secret: "123", blockIds: ["456", "789"] } ```

NameTypeRequiredDescription

blockIdsarrayrequiredIds of blocks to delete. Each block is deleted with all its children

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_delete_entities#Permanently deletes entities from a database by their IDs.2 params▾

Permanently deletes entities from a database by their IDs.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

idsarrayrequiredArray of entity IDs (fibery/id) to delete

fiberymcp_delete_fields#Deletes one or more fields from their databases; restorable via the Activity Log.1 param▾

Deletes one or more fields from their databases; restorable via the Activity Log.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_delete_icon_fields#Removes icon fields from one or more databases; restorable via the Activity Log.1 param▾

Removes icon fields from one or more databases; restorable via the Activity Log.

NameTypeRequiredDescription

databasesarrayrequiredArray of full database names (e.g., ["SoftDev/Task"])

fiberymcp_delete_space#Deletes a space and all its databases from the workspace; restorable via the Activity Log.1 param▾

Deletes a space and all its databases from the workspace; restorable via the Activity Log.

NameTypeRequiredDescription

namestringrequiredSpace name to delete (e.g., "SoftDev")

fiberymcp_delete_views#Deletes one or more Fibery views by ID; the underlying data is not removed.1 param▾

Deletes one or more Fibery views by ID; the underlying data is not removed.

NameTypeRequiredDescription

idsarrayrequiredAn array of fibery/id strings (of views) to be deleted

fiberymcp_delete_workflow_field#Deletes the workflow (state) field from a database; restorable via the Activity Log.1 param▾

Deletes the workflow (state) field from a database; restorable via the Activity Log.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

fiberymcp_display_entity_capabilities_via_sharing#Returns per-entity capabilities derived from sharing for the requested Fibery databases. Use this when the user wants to know what access they have at the entity level (not just space- or database-level). For each database, the response includes the entities they can reach and how they reach them. Three access paths are covered: 1. **Direct sharing** — the entity was explicitly shared with the user, returned in `entityLevelGrants`. 2. **Propagated sharing** — access was inherited from a related entity, returned in `indirectEntityLevelGrants`. 3. **Assignment rules** — the user appears in a People-field rule on the entity type, returned in `assigneeGrants`. Capabilities from every source (space-level, database-level, per-entity grants, propagation from other databases) ACCUMULATE — they NEVER override. To compute effective capabilities on a specific entity, take the UNION of all sources. Limitations for assignee grants: sample only (up to 10 entities per rule) Per-database result fields: - `spaceLevelCapabilities` — capabilities granted at the space level. - `databaseLevelCapabilities` — capabilities granted at the database level. - `entityLevelGrants` — per-entity grants from direct sharing. - `indirectEntityLevelGrants` — grants propagated from related entities. - `assigneeGrants` — grants derived from assignment rules on People-type fields. If a database can't be resolved in the schema, its entry is `{database, error}` instead.1 param▾

Returns per-entity capabilities derived from sharing for the requested Fibery databases. Use this when the user wants to know what access they have at the entity level (not just space- or database-level). For each database, the response includes the entities they can reach and how they reach them. Three access paths are covered: 1. **Direct sharing** — the entity was explicitly shared with the user, returned in `entityLevelGrants`. 2. **Propagated sharing** — access was inherited from a related entity, returned in `indirectEntityLevelGrants`. 3. **Assignment rules** — the user appears in a People-field rule on the entity type, returned in `assigneeGrants`. Capabilities from every source (space-level, database-level, per-entity grants, propagation from other databases) ACCUMULATE — they NEVER override. To compute effective capabilities on a specific entity, take the UNION of all sources. Limitations for assignee grants: sample only (up to 10 entities per rule) Per-database result fields: - `spaceLevelCapabilities` — capabilities granted at the space level. - `databaseLevelCapabilities` — capabilities granted at the database level. - `entityLevelGrants` — per-entity grants from direct sharing. - `indirectEntityLevelGrants` — grants propagated from related entities. - `assigneeGrants` — grants derived from assignment rules on People-type fields. If a database can't be resolved in the schema, its entry is `{database, error}` instead.

NameTypeRequiredDescription

databasesarrayrequiredFull database names in "Space/Database" format (e.g. ["Project Management/Feature"]).

fiberymcp_display_report_schema#Get the vizydrop report source schema for one or more Fibery databases. This is distinct from the Fibery type/relation schema returned by `schema` or `schema_detailed`. Returns the flat set of fields and enum values usable in report dimension/metric expressions and filter conditions. Call this before configuring chart, table, or metric dimensions so you know the valid field names and types. **`sourceMode`**: `current` (default) for live entity state; `historical` for modification events (time-in-state data). When multiple databases are specified, a synthetic `Entity Database` field is added to allow splitting results by source. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.2 params▾

Get the vizydrop report source schema for one or more Fibery databases. This is distinct from the Fibery type/relation schema returned by `schema` or `schema_detailed`. Returns the flat set of fields and enum values usable in report dimension/metric expressions and filter conditions. Call this before configuring chart, table, or metric dimensions so you know the valid field names and types. **`sourceMode`**: `current` (default) for live entity state; `historical` for modification events (time-in-state data). When multiple databases are specified, a synthetic `Entity Database` field is added to allow splitting results by source. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

databasesarrayrequiredList of database names in 'Space/Database' format to get the report source schema for.

sourceModestringoptionalSource mode: 'current' (default) queries live entity state; 'historical' resolves a history-timeline source for time-in-state / change-frequency analysis.

fiberymcp_display_schema_capabilities#Returns the current user's access info per space and per database in the Fibery workspace. Use this when explaining what the user can/cannot do, or before suggesting an action that requires specific access. URL conventions: - For spaces: user will see anything if they have ANY access to the space. - For databases: user will see anything only if they have architect-level access; otherwise it will render as "No Access". Capabilities from every source (space-level, database-level, per-entity grants, propagation from other databases) ACCUMULATE — they NEVER override. To compute the user's effective capabilities on a specific entity, take the UNION of all sources. The response shape: - `accessInfo.spaces` — map keyed by space namespace. - `accessInfo.databases` — map keyed by `Space/Database` name. Each entry value is one of: - `'no-access'` — the user has no access. - `'entity-level'` — no space/database-level grant, but the user has access to at least one entity via an entity-level access template. - `{level, templateId, isDefault, url}` — standard template-based access. `level` is the template name with the `app.access/` / `type.access/` prefix stripped. `isDefault: false` indicates a custom template. - `'derived-per-field'` — applies only to `fibery/file` and `comments/comment`; access is granted via per-field grants on the owning database, not at the type level. - `levelInfo.space` and `levelInfo.database` — keyed by `level` (the same string as above); each value carries the template's full title, description, and capability set so the caller can explain what a level grants.1 param▾

Returns the current user's access info per space and per database in the Fibery workspace. Use this when explaining what the user can/cannot do, or before suggesting an action that requires specific access. URL conventions: - For spaces: user will see anything if they have ANY access to the space. - For databases: user will see anything only if they have architect-level access; otherwise it will render as "No Access". Capabilities from every source (space-level, database-level, per-entity grants, propagation from other databases) ACCUMULATE — they NEVER override. To compute the user's effective capabilities on a specific entity, take the UNION of all sources. The response shape: - `accessInfo.spaces` — map keyed by space namespace. - `accessInfo.databases` — map keyed by `Space/Database` name. Each entry value is one of: - `'no-access'` — the user has no access. - `'entity-level'` — no space/database-level grant, but the user has access to at least one entity via an entity-level access template. - `{level, templateId, isDefault, url}` — standard template-based access. `level` is the template name with the `app.access/` / `type.access/` prefix stripped. `isDefault: false` indicates a custom template. - `'derived-per-field'` — applies only to `fibery/file` and `comments/comment`; access is granted via per-field grants on the owning database, not at the type level. - `levelInfo.space` and `levelInfo.database` — keyed by `level` (the same string as above); each value carries the template's full title, description, and capability set so the caller can explain what a level grants.

NameTypeRequiredDescription

spacesarrayoptionalOptional list of space names to scope the response (e.g. ['Product', 'Sales']). Omit to receive capabilities for every space and database in the workspace.

fiberymcp_download_file#Fetches a Fibery file attachment by secret and returns a signed download URL valid for ~60 minutes.1 param▾

Fetches a Fibery file attachment by secret and returns a signed download URL valid for ~60 minutes.

NameTypeRequiredDescription

secretstringrequiredFile secret obtained from get_files_meta — opaque identifier returned in each file entry.

fiberymcp_fetch_by_url#Fetches entity or view data from a Fibery URL and returns it as Markdown.2 params▾

Fetches entity or view data from a Fibery URL and returns it as Markdown.

NameTypeRequiredDescription

urlstringrequiredFibery URL to fetch data from

limitnumberoptionalMaximum number of items to return for views (default: 20)

fiberymcp_fetch_view_data#Fetches entity data from a Fibery view by executing its saved query.3 params▾

Fetches entity data from a Fibery view by executing its saved query.

NameTypeRequiredDescription

publicIdstringrequiredPublic ID of the view to fetch data from

limitnumberoptionalMax entities to return (default: 100)

offsetnumberoptionalNumber of entities to skip (default: 0)

fiberymcp_get_connectors_list#Returns a list of available built-in connectors (integrations) in Fibery.0 params▾

Returns a list of available built-in connectors (integrations) in Fibery.

fiberymcp_get_custom_apps_list#List the workspace's custom apps the user can see. Custom apps are small React apps embedded in Fibery views. Use the `id` to work on an app's source code with the custom-app development flow — call `get_fibery_skill({skill: "custom-apps-dev"})` for the full guide.0 params▾

List the workspace's custom apps the user can see. Custom apps are small React apps embedded in Fibery views. Use the `id` to work on an app's source code with the custom-app development flow — call `get_fibery_skill({skill: "custom-apps-dev"})` for the full guide.

fiberymcp_get_documents_content#[STALE: removed upstream, replaced by read_document] Returns the Markdown content of one or more Fibery document fields identified by their secrets.2 params▾

[STALE: removed upstream, replaced by read_document] Returns the Markdown content of one or more Fibery document fields identified by their secrets.

NameTypeRequiredDescription

secretsarrayrequiredSecrets of documents

reducePromptstringoptionalControls how large documents are summarized when too long. By default: 'Summarize this document in 2-3 paragraphs max.'

fiberymcp_get_entity_links#Generates Fibery web links for entities by their public IDs.2 params▾

Generates Fibery web links for entities by their public IDs.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityPublicIdsarrayrequiredArray of entity public IDs (e.g., ['42', '43'])

fiberymcp_get_entity_mention#Builds an inline entity reference for document markdown. When the document is shown, it renders as a "live" entity which has current name, with a link. Embed the returned string into content passed to the document editing tools (`insert_document_blocks`, `set_block_text`, comment bodies). Call `get_fibery_skill({skill: "documents"})` for the markdown reference. ## Example ``` { database: "SoftDev/Task", entityId: "123", label: "Fix login bug" } ```3 params▾

Builds an inline entity reference for document markdown. When the document is shown, it renders as a "live" entity which has current name, with a link. Embed the returned string into content passed to the document editing tools (`insert_document_blocks`, `set_block_text`, comment bodies). Call `get_fibery_skill({skill: "documents"})` for the markdown reference. ## Example ``` { database: "SoftDev/Task", entityId: "123", label: "Fix login bug" } ```

NameTypeRequiredDescription

databasestringrequiredFull database name in "Space/Type" format (e.g., 'Projects/Task')

entityIdstringrequiredEntity UUID (fibery/id)

labelstringrequiredFallback display text

fiberymcp_get_fibery_skill#Load the full guide for a Fibery skill domain. Call this tool when you need the complete reference for a domain that spans multiple tools. Each skill covers the full model, expression syntax, configuration shapes, conditions, and workflow for its related tools.1 param▾

Load the full guide for a Fibery skill domain. Call this tool when you need the complete reference for a domain that spans multiple tools. Each skill covers the full model, expression syntax, configuration shapes, conditions, and workflow for its related tools.

NameTypeRequiredDescription

skillstringrequiredThe skill domain to load. Use one of the listed enum values.

fiberymcp_get_files_meta#Lists file attachments on one or more Fibery entities and returns their metadata.3 params▾

Lists file attachments on one or more Fibery entities and returns their metadata.

NameTypeRequiredDescription

databasestringrequiredFull database name in 'Space/Type' format, e.g. 'SoftDev/Task'. Use `schema` to discover available databases.

entityIdsarrayrequiredOne or more fibery/id UUIDs of the entities whose file attachments to list.

fieldstringoptionalName of a specific file field to query. Omit to scan all file fields on the database. Use `schema_detailed` to discover available file fields.

fiberymcp_get_manual_import_link#Generates a link to the manual import page for a Fibery connector.4 params▾

Generates a link to the manual import page for a Fibery connector.

NameTypeRequiredDescription

connectorIdstringrequiredID of the connector to be used (obtained from get_connectors_list)

isSyncbooleanrequiredWhether the data from the source will be synced continuously (true) or imported once (false)

spaceNamestringrequiredThe name of the space to import into

dbNamestringoptionalThe name of the existing database to import into. Leave empty to import into a new database in the space.

fiberymcp_get_me#Returns information about the currently authenticated Fibery user.0 params▾

Returns information about the currently authenticated Fibery user.

fiberymcp_get_report#Fetch a Fibery report (vizydrop view) by its UUID, including its tabs, sources, schema, and dimension configuration. Use `get_reports_list` first to discover available report IDs. The response includes `tabId`, `tabType`, and per-dimension `id` values needed by `update_tab`, `update_dimension`, and `remove_dimension`. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.1 param▾

Fetch a Fibery report (vizydrop view) by its UUID, including its tabs, sources, schema, and dimension configuration. Use `get_reports_list` first to discover available report IDs. The response includes `tabId`, `tabType`, and per-dimension `id` values needed by `update_tab`, `update_dimension`, and `remove_dimension`. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

reportIdstringrequiredThe UUID of the report view to fetch.

fiberymcp_get_reports_list#List all vizydrop report views in the Fibery workspace. Returns an array of report summaries with `id` and `title`. Use the `id` field with `get_report` to fetch full details including tab structure and dimension IDs. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.0 params▾

List all vizydrop report views in the Fibery workspace. Returns an array of report summaries with `id` and `title`. Use the `id` field with `get_report` to fetch full details including tab structure and dimension IDs. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

fiberymcp_get_tool_reference#[STALE: removed upstream, replaced by get_fibery_skill] Returns extended reference documentation for a specific Fibery MCP tool.1 param▾

[STALE: removed upstream, replaced by get_fibery_skill] Returns extended reference documentation for a specific Fibery MCP tool.

NameTypeRequiredDescription

toolNamestringrequiredThe snake_case MCP tool name to look up (e.g. 'query', 'create_entities')

fiberymcp_get_user_mention#Builds an inline user mention for document markdown, works the same as `get_entity_mention`, but for the `fibery/user` database. When the document is shown, it renders as a "live" user mention. Embed the returned string into content passed to the document editing tools (`insert_document_blocks`, `set_block_text`, comment bodies). Get user ids via `query` from the `fibery/user` database, or your own id via `get_me`. Call `get_fibery_skill({skill: "documents"})` for the markdown reference. ## Example ``` { userId: "123", label: "Alice" } ```2 params▾

Builds an inline user mention for document markdown, works the same as `get_entity_mention`, but for the `fibery/user` database. When the document is shown, it renders as a "live" user mention. Embed the returned string into content passed to the document editing tools (`insert_document_blocks`, `set_block_text`, comment bodies). Get user ids via `query` from the `fibery/user` database, or your own id via `get_me`. Call `get_fibery_skill({skill: "documents"})` for the markdown reference. ## Example ``` { userId: "123", label: "Alice" } ```

NameTypeRequiredDescription

labelstringrequiredFallback display text

userIdstringrequiredUser UUID (fibery/id from the 'fibery/user' database)

fiberymcp_insert_document_blocks#Inserts new blocks into a document from markdown. Call `get_fibery_skill({skill: "documents"})` first. It covers the full markdown reference (headings, lists, tables, code, math, images/videos, callouts, highlights, entity references), content adaptation rules, and the editing workflow. Call `read_document` for block ids to anchor to (not needed when inserting at the document root with `parent: {blockId: null, ...}`). ## Example Append a section to the end of a document: ``` { secret: "123", inserts: [{parent: {blockId: null, position: "end"}, content: "## Next steps\n\n- [ ] review\n- [ ] deploy"}] } ```2 params▾

Inserts new blocks into a document from markdown. Call `get_fibery_skill({skill: "documents"})` first. It covers the full markdown reference (headings, lists, tables, code, math, images/videos, callouts, highlights, entity references), content adaptation rules, and the editing workflow. Call `read_document` for block ids to anchor to (not needed when inserting at the document root with `parent: {blockId: null, ...}`). ## Example Append a section to the end of a document: ``` { secret: "123", inserts: [{parent: {blockId: null, position: "end"}, content: "## Next steps\n\n- [ ] review\n- [ ] deploy"}] } ```

NameTypeRequiredDescription

insertsarrayrequiredInsertions to perform. Each item must have exactly ONE anchor: after, before or parent

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_move_document_blocks#Moves blocks (each with all its children) to a new position in the document. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model and the editing workflow. ## Example Move a block to the end of the document: ``` { secret: "123", moves: [{blockId: "456", parent: {blockId: null, position: "end"}}] } ```2 params▾

Moves blocks (each with all its children) to a new position in the document. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model and the editing workflow. ## Example Move a block to the end of the document: ``` { secret: "123", moves: [{blockId: "456", parent: {blockId: null, position: "end"}}] } ```

NameTypeRequiredDescription

movesarrayrequiredMoves to perform. Each item must have exactly ONE anchor: after, before or parent

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_query#Runs a structured Fibery query to select, filter, order, paginate, and aggregate data.2 params▾

Runs a structured Fibery query to select, filter, order, paginate, and aggregate data.

NameTypeRequiredDescription

queryobjectrequiredNo description.

paramsobjectoptionalNot used anymore, left for backwards compatibility

fiberymcp_query_views#Queries saved views in the Fibery workspace, optionally filtering by ID, public ID, name, or type.5 params▾

Queries saved views in the Fibery workspace, optionally filtering by ID, public ID, name, or type.

NameTypeRequiredDescription

idstringoptionalFilter by fibery/id of the view

publicIdstringoptionalFilter by public ID of the view

textstringoptionalText search in view name or description

viewTypestringoptionalFilter by view type

withConfigbooleanoptionalSpecify whether to include view config (like, what database are present on this view, what fields are shown). true by default. Set to false if not filtering by id filters since there can be many views returned

fiberymcp_read_document#Reads a single document as a flat list of addressable blocks with stable ids. Call this before any document editing tool — the returned block ids are required by all of them. **Call `get_fibery_skill({skill: "documents"})` FIRST** — it covers how to find document secrets (via `query` or `search`), the snapshot anatomy, the block model, inline comments, and the whole editing workflow. Returns a TOON-encoded snapshot: `version`, `rootBlockIds` (ordered top-level ids), `blocks` in document order (each with `id`, `type`, `parentId` — `null` = top level, `attrs`, `content`, `index`), plus a `comments` section when the document has inline comment threads.1 param▾

Reads a single document as a flat list of addressable blocks with stable ids. Call this before any document editing tool — the returned block ids are required by all of them. **Call `get_fibery_skill({skill: "documents"})` FIRST** — it covers how to find document secrets (via `query` or `search`), the snapshot anatomy, the block model, inline comments, and the whole editing workflow. Returns a TOON-encoded snapshot: `version`, `rootBlockIds` (ordered top-level ids), `blocks` in document order (each with `id`, `type`, `parentId` — `null` = top level, `attrs`, `content`, `index`), plus a `comments` section when the document has inline comment threads.

NameTypeRequiredDescription

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_remove_collection_items#Removes related entities from a Collection field on a Fibery entity.4 params▾

Removes related entities from a Collection field on a Fibery entity.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

fieldstringrequiredThe name of the collection field

itemsarrayrequiredAn array of related entity ids to remove from the collection. Each entry must be fibery/id of the entity to add

fiberymcp_remove_dimension#Removes a single dimension from a tab in a Fibery report. Use `get_report` to find the `tabId`, `tabType`, and the dimension `id` (from `result.tabs[].x[].id`, `.y[].id`, `.columns[].id`, `.metrics[].id`, etc.). **This action is irreversible** — the dimension is permanently removed from the tab's specification. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.4 params▾

Removes a single dimension from a tab in a Fibery report. Use `get_report` to find the `tabId`, `tabType`, and the dimension `id` (from `result.tabs[].x[].id`, `.y[].id`, `.columns[].id`, `.metrics[].id`, etc.). **This action is irreversible** — the dimension is permanently removed from the tab's specification. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

dimensionIdstringrequiredID of the dimension to remove (from get_report result.tabs[].x[].id, .y[].id, .columns[].id, etc.).

reportIdstringrequiredUUID of the report containing the tab.

tabIdstringrequiredID of the tab containing the dimension (from get_report result.tabs[].id).

tabTypestringrequiredType of the tab — required so the server picks the right update command.

fiberymcp_remove_tab#Removes a tab from an existing Fibery report. Use `get_report` to find the `tabId` of the tab you want to remove (each tab object in `result.tabs` has an `id` field). **This action is irreversible** — the tab and all its dimensions/conditions will be permanently deleted. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.2 params▾

Removes a tab from an existing Fibery report. Use `get_report` to find the `tabId` of the tab you want to remove (each tab object in `result.tabs` has an `id` field). **This action is irreversible** — the tab and all its dimensions/conditions will be permanently deleted. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

reportIdstringrequiredUUID of the report containing the tab.

tabIdstringrequiredID of the tab to remove (from get_report result.tabs[].id).

fiberymcp_rename_databases#Renames one or more databases, optionally moving them to a different space.1 param▾

Renames one or more databases, optionally moving them to a different space.

NameTypeRequiredDescription

databasesarrayrequiredNo description.

fiberymcp_rename_fields#Renames one or more fields within their databases.1 param▾

Renames one or more fields within their databases.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_replace_block_text#Replaces one occurrence of exact text inside a block, leaving the rest untouched. The preferred tool for small fixes — surrounding formatting and inline comments survive. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for selector semantics, the block model, and the editing workflow. `exact` is the block's plain text with marks stripped, as shown in `read_document` — never markdown (e.g., match by `text`, not by `**text**`). `replacement` is inserted literal: markdown/HTML is NOT parsed and no marks are applied, so this tool cannot add or change formatting (bold, underline, links, colors). To change formatting on a span, rewrite the whole block with `set_block_text`. ## Example ``` { secret: "123", replacements: [{blockId: "456", exact: "teh", replacement: "the"}] } ```2 params▾

Replaces one occurrence of exact text inside a block, leaving the rest untouched. The preferred tool for small fixes — surrounding formatting and inline comments survive. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for selector semantics, the block model, and the editing workflow. `exact` is the block's plain text with marks stripped, as shown in `read_document` — never markdown (e.g., match by `text`, not by `**text**`). `replacement` is inserted literal: markdown/HTML is NOT parsed and no marks are applied, so this tool cannot add or change formatting (bold, underline, links, colors). To change formatting on a span, rewrite the whole block with `set_block_text`. ## Example ``` { secret: "123", replacements: [{blockId: "456", exact: "teh", replacement: "the"}] } ```

NameTypeRequiredDescription

replacementsarrayrequiredReplacements to perform

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_reply_document_comment#Adds replies to existing inline comment threads in a document. The reply author is the current user. Call `get_fibery_skill({skill: "documents"})` for the comment thread model. ## Example ``` { secret: "123", replies: [{commentId: "456", content: "Done — rewrote the section above."}] } ```2 params▾

Adds replies to existing inline comment threads in a document. The reply author is the current user. Call `get_fibery_skill({skill: "documents"})` for the comment thread model. ## Example ``` { secret: "123", replies: [{commentId: "456", content: "Done — rewrote the section above."}] } ```

NameTypeRequiredDescription

repliesarrayrequiredReplies to add

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_schema#Returns the high-level workspace structure showing all spaces and databases.0 params▾

Returns the high-level workspace structure showing all spaces and databases.

fiberymcp_schema_detailed#Returns detailed schema for specified databases, including fields and related databases.2 params▾

Returns detailed schema for specified databases, including fields and related databases.

NameTypeRequiredDescription

databasesarrayrequiredAn array of database names (in "Space/Database" format).

includeRelatedDatabasesbooleanoptionalWhether to include related databases with their descriptions & fields. Defaults to false. Set to true if the schema is small and you want to navigate faster.

fiberymcp_search#Searches workspace content using BM-25 keyword matching.4 params▾

Searches workspace content using BM-25 keyword matching.

NameTypeRequiredDescription

querystringrequiredSearch query string

databasestringoptionalFilter results to a specific database (e.g., 'Projects/Task')

limitnumberoptionalMaximum number of items to return (default: 20, max: 100)

viewTypestringoptionalFilter results to a specific view type

fiberymcp_search_guide#Fetches relevant information from the Fibery User Guide based on a query.1 param▾

Fetches relevant information from the Fibery User Guide based on a query.

NameTypeRequiredDescription

querystringrequiredThe query for searching

fiberymcp_search_history#Searches the workspace activity history and returns matching history events.13 params▾

Searches the workspace activity history and returns matching history events.

NameTypeRequiredDescription

actionsarrayoptionalFilter by action types

authorUserIdstringoptionalFilter by author's fibery/id

databasestringoptionalFilter by database name (e.g., 'Projects/Task')

entityIdstringoptionalFilter by entity fibery/id

entityNamestringoptionalFilter by entity name (substring match)

entityPublicIdstringoptionalFilter by entity public ID (requires database to be set)

entityStatearrayoptionalFilter by entity states

excludeAutomaticChangesstringoptionalExclude automatic changes (all excluded by default)

limitnumberoptionalMaximum number of items to return (default: 50, max: 100)

schemaChangearrayoptionalFilter by schema change types

sincestringoptionalStart of time range (ISO 8601). Defaults to 24 hours ago

sinceItemstringoptionalCursor for pagination — last item ID from previous result

untilstringoptionalEnd of time range (ISO 8601). Defaults to now. Difference between dates in until and since cannot be more than 12 months

fiberymcp_set_block_attrs#Merges attributes into blocks' attrs (e.g. heading level, task state, code block language, callout icon). Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the per-block-type attrs catalog. ## Example Turn a heading into level 3 and mark a task done: ``` { secret: "123", blocks: [ {blockId: "456", attrs: {level: 3}}, {blockId: "789", attrs: {state: "DONE"}} ] } ```2 params▾

Merges attributes into blocks' attrs (e.g. heading level, task state, code block language, callout icon). Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the per-block-type attrs catalog. ## Example Turn a heading into level 3 and mark a task done: ``` { secret: "123", blocks: [ {blockId: "456", attrs: {level: 3}}, {blockId: "789", attrs: {state: "DONE"}} ] } ```

NameTypeRequiredDescription

blocksarrayrequiredAttribute updates to perform

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_set_block_text#Rewrites the inline content of text blocks from markdown. Keeps each block's type, attrs and id. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model, the inline markdown reference, and the editing workflow. **Prefer `replace_block_text` for small fixes** — it touches only the matched text and preserves surrounding formatting and comments. Use this tool to rewrite a whole block. Each `content` must resolve to a **single top-level block** — it replaces one block's inline content, it does NOT add blocks. Multi-block markdown (heading + paragraph, several paragraphs, a list, `---`) is rejected. To add blocks use `insert_document_blocks`; to change a block's type use `set_block_attrs`. ## Example ``` { secret: "123", blocks: [{blockId: "456", content: "Updated **summary** of findings"}] } ```2 params▾

Rewrites the inline content of text blocks from markdown. Keeps each block's type, attrs and id. Call `read_document` first to get block ids. Call `get_fibery_skill({skill: "documents"})` for the block model, the inline markdown reference, and the editing workflow. **Prefer `replace_block_text` for small fixes** — it touches only the matched text and preserves surrounding formatting and comments. Use this tool to rewrite a whole block. Each `content` must resolve to a **single top-level block** — it replaces one block's inline content, it does NOT add blocks. Multi-block markdown (heading + paragraph, several paragraphs, a list, `---`) is rejected. To add blocks use `insert_document_blocks`; to change a block's type use `set_block_attrs`. ## Example ``` { secret: "123", blocks: [{blockId: "456", content: "Updated **summary** of findings"}] } ```

NameTypeRequiredDescription

blocksarrayrequiredBlocks to rewrite

secretstringrequiredDocument secret (UUID). For entity document fields, select the field's secret via query (e.g. {Secret: ['Space/Field', 'Collaboration~Documents/secret']}). For standalone documents, use search with viewType 'document'

fiberymcp_set_document_content#[STALE: removed upstream, replaced by block-based document tools (set_block_text/replace_block_text/insert_document_blocks)] Sets (replaces) the content of a document field on a Fibery entity.4 params▾

[STALE: removed upstream, replaced by block-based document tools (set_block_text/replace_block_text/insert_document_blocks)] Sets (replaces) the content of a document field on a Fibery entity.

NameTypeRequiredDescription

contentstringrequiredDocument's content in MD format. It has to be full document content

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

fieldstringrequiredThe name of the document field

fiberymcp_set_state#Sets the workflow state of a Fibery entity.3 params▾

Sets the workflow state of a Fibery entity.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entityIdstringrequiredfibery/id of an entity

statestringrequiredState title (enum/name)

fiberymcp_update_dimension#Updates an existing dimension in a report tab. Use `get_report` to find the `tabId`, `tabType`, and per-dimension `id` values. Each dimension object in the tab's axis arrays (`x`, `y`, `columns`, `metrics`, etc.) has an `id` field — pass that as `dimensionId`. **`changes`** is a partial object: only the keys you provide will be merged into the existing dimension. Omit keys you do not want to change. To add or remove dimensions entirely, use `remove_dimension` or recreate the tab with the add-tab tools. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.5 params▾

Updates an existing dimension in a report tab. Use `get_report` to find the `tabId`, `tabType`, and per-dimension `id` values. Each dimension object in the tab's axis arrays (`x`, `y`, `columns`, `metrics`, etc.) has an `id` field — pass that as `dimensionId`. **`changes`** is a partial object: only the keys you provide will be merged into the existing dimension. Omit keys you do not want to change. To add or remove dimensions entirely, use `remove_dimension` or recreate the tab with the add-tab tools. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

changesobjectrequiredPartial dimension update. Only provided keys are merged into the existing dimension.

dimensionIdstringrequiredID of the dimension to update (from get_report result.tabs[].x[].id, .y[].id, .columns[].id, etc.).

reportIdstringrequiredUUID of the report containing the tab.

tabIdstringrequiredID of the tab containing the dimension (from get_report result.tabs[].id).

tabTypestringrequiredType of the tab — required so the server picks the right update command.

fiberymcp_update_entities#Updates fields on one or more existing Fibery entities.2 params▾

Updates fields on one or more existing Fibery entities.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

entitiesarrayrequiredNo description.

fiberymcp_update_formula_field#Updates an existing formula field by regenerating its expression from a new description.3 params▾

Updates an existing formula field by regenerating its expression from a new description.

NameTypeRequiredDescription

databasestringrequiredFull database name (e.g., 'SoftDev/Task')

descriptionstringrequiredNew description of what the formula should calculate. A new formula expression will be generated from this

namestringrequiredName of the existing formula field in {Space}/{Field} format (e.g., 'SoftDev/Days Since Created')

fiberymcp_update_multi_select_fields#Updates the options of one or more existing multi-select fields.1 param▾

Updates the options of one or more existing multi-select fields.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_update_report#Updates an existing Fibery report's title and/or sources. **At least one of `title` or `sources` must be provided.** Use `get_report` to retrieve the current report state and `reportId` before calling this tool. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.3 params▾

Updates an existing Fibery report's title and/or sources. **At least one of `title` or `sources` must be provided.** Use `get_report` to retrieve the current report state and `reportId` before calling this tool. Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

reportIdstringrequiredUUID of the report to update (from get_report or get_reports_list).

sourcesarrayoptionalReplace the report's source databases; source mode is fixed at creation and cannot change here.

titlestringoptionalNew title for the report.

fiberymcp_update_single_select_fields#Updates the options of one or more existing single-select fields.1 param▾

Updates the options of one or more existing single-select fields.

NameTypeRequiredDescription

fieldsarrayrequiredNo description.

fiberymcp_update_tab#Updates scalar properties of an existing tab in a Fibery report. Use `get_report` to find the `tabId` and `tabType` of the tab to update. **What this tool can change:** `title`, `type` / `palette` (chart tabs only), `fieldConditions` / `dimensionConditions` (replaces the tab's filter set entirely). **What this tool cannot do:** Add or remove dimensions (use `update_dimension` / `remove_dimension` or recreate the tab). Change `tabType` (recreate the tab instead). Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.8 params▾

Updates scalar properties of an existing tab in a Fibery report. Use `get_report` to find the `tabId` and `tabType` of the tab to update. **What this tool can change:** `title`, `type` / `palette` (chart tabs only), `fieldConditions` / `dimensionConditions` (replaces the tab's filter set entirely). **What this tool cannot do:** Add or remove dimensions (use `update_dimension` / `remove_dimension` or recreate the tab). Change `tabType` (recreate the tab instead). Reports are a specialized domain — call `get_fibery_skill` with `skill: "reports"` for the full report model, expression syntax, palettes, conditions, and workflow.

NameTypeRequiredDescription

reportIdstringrequiredUUID of the report containing the tab.

tabIdstringrequiredID of the tab to update (from get_report result.tabs[].id).

tabTypestringrequiredType of the tab — required so the server picks the right update command.

dimensionConditionsarrayoptionalReplace the tab's dimension-level filters entirely.

fieldConditionsarrayoptionalReplace the tab's field-level filters entirely.

palettestringoptionalColor palette. Applies to chart tabs only; ignored for table/metric.

titlestringoptionalNew tab title.

typestringoptionalChart type. Applies to chart tabs only; ignored for table/metric.

fiberymcp_update_view#Updates an existing Fibery view's name, description, space, content, or configuration.8 params▾

Updates an existing Fibery view's name, description, space, content, or configuration.

NameTypeRequiredDescription

idstringrequiredfibery/id of the view to update

viewTypestringrequiredgrid: spreadsheet table (supports hierarchical groupBy). list: simple list (prefer grid). board: kanban grouped by relation/enum on x and optionally y. timeline: time bars with optional milestones and dependencies. calendar: date events. map: geographic plot of a location field. feed: rich-text feed of a document field. gallery: card gallery with cover images. gantt: hierarchical timeline with dependencies. form: data input form. document: standalone markdown (use the `content` param). report: not yet supported here.

appendbooleanoptionalIf true, append content instead of replacing (document views only)

configobjectoptionalView configuration object. Shape depends on viewType — for anything beyond a basic grid/list with no filters or ordering, call get_tool_reference({toolName: 'create_view'}) first.

contentstringoptionalMarkdown content (for document views)

descriptionstringoptionalNew description for the view

namestringoptionalNew name for the view

spacestringoptionalMove the view to a different space

fiberymcp_update_workflow_field#Updates the options of an existing workflow (state) field.3 params▾

Updates the options of an existing workflow (state) field.

NameTypeRequiredDescription

databasestringrequiredFull database name

updatestringrequiredFull replacement or incremental update

defaultOptionstringoptionalNew default state name. If not provided, the default is left unchanged