> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns. > > **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal): > ```bash > npx -y @scalekit-inc/cli setup -y > ``` > > Global: > ```bash > npm install -g @scalekit-inc/cli > scalekit setup -y > ``` > > Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`. > Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim. > [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # Connect AI agents to the Lucid MCP server The Lucid MCP connector routes your AI agent's tool calls to Lucid's own MCP server through Scalekit. Each user signs in to Lucid once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 35 tools. **Authentication:** OAuth 2.1/DCR **Categories:** Design, Productivity, Collaboration **Tools:** 35: 13 read, 17 write, 5 destructive **Users sign in with:** OAuth **OAuth app:** Scalekit's or your own **Built by:** Vendor MCP **Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=LUCIDMCP) ## Setup 1. ### Install the SDK **Node.js** ```bash npm install @scalekit-sdk/node dotenv ``` **Python** ```bash pip install scalekit-sdk-python python-dotenv ``` 2. ### Set your credentials Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**. ```sh title=".env" SCALEKIT_ENVIRONMENT_URL= SCALEKIT_CLIENT_ID= SCALEKIT_CLIENT_SECRET= ``` 3. ### Create the Lucid MCP connection In **AgentKit > Connections**, create a Lucid MCP connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/). Scalekit credentials are available for Lucid MCP server, so you don't need to register an OAuth app. 4. ### Authorize a user and make your first call **Node.js** (`quickstart.mts`) ```typescript import { ScalekitClient } from '@scalekit-sdk/node' import 'dotenv/config' import { createInterface } from 'node:readline/promises' const scalekit = new ScalekitClient( process.env.SCALEKIT_ENVIRONMENT_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET, ) const actions = scalekit.actions const connector = 'lucidmcp' const identifier = 'user_123' // Generate an authorization link for the user const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier }) console.log('Authorize Lucid MCP:', link) const rl = createInterface({ input: process.stdin, output: process.stdout }) await rl.question('Press Enter after authorizing...') rl.close() // Make your first call const result = await actions.executeTool({ connector, identifier, toolName: 'lucidmcp_get_mcp_resource', toolInput: {}, }) console.log(result) ``` ```bash npx tsx quickstart.mts ``` **Python** (`quickstart.py`) ```python import os from scalekit import ScalekitClient from dotenv import load_dotenv load_dotenv() scalekit_client = ScalekitClient( env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"), client_id=os.getenv("SCALEKIT_CLIENT_ID"), client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"), ) actions = scalekit_client.actions connection_name = "lucidmcp" identifier = "user_123" # Generate an authorization link for the user link_response = actions.get_authorization_link( connection_name=connection_name, identifier=identifier, ) print("Authorize Lucid MCP:", link_response.link) input("Press Enter after authorizing...") # Make your first call result = actions.execute_tool( tool_input={}, tool_name="lucidmcp_get_mcp_resource", connection_name=connection_name, identifier=identifier, ) print(result) ``` ```bash python quickstart.py ``` Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses. ## Tools Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool). **Node.js** ```typescript const result = await actions.executeTool({ toolName: 'lucidmcp_fetch', toolInput: { id: '', }, connector: 'lucidmcp', identifier: 'user_123', }) ``` **Python** ```python result = actions.execute_tool( tool_name="lucidmcp_fetch", tool_input={ "id": "", }, connection_name="lucidmcp", identifier="user_123", ) ``` `result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call. ### `lucidmcp_fetch` Fetch · Read-only Retrieve the structured content of a Lucid document by ID, including pages, blocks, and lines. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `id` (`string`, required): No description. - `metadata_only` (`string`, optional): No description. Default: `false`. - `page_index` (`string`, optional): No description. - `region_index` (`string`, optional): No description. Example input: `{"id":""}` ### `lucidmcp_get_mcp_resource` Get Mcp Resource · Read-only Read a resource from the Lucid MCP server by its URI. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `resource_uri` (`string`, optional): No description. Default: ``. Example input: `{}` ### `lucidmcp_list_document_thread_comments` List Document Thread Comments · Read-only List comments on a specific collaboration thread of a Lucid document. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `thread_id` (`string`, required): No description. Example input: `{"document_id":"","thread_id":""}` ### `lucidmcp_list_document_threads` List Document Threads · Read-only List collaboration threads on a Lucid document. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. Example input: `{"document_id":""}` ### `lucidmcp_lucid_export_document_as_png` Lucid Export Document As PNG · Read-only Export a page of a Lucid document as a PNG image. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `bounding_box` (`string`, optional): No description. - `page` (`integer`, optional): No description. Default: `1`. Example input: `{"document_id":""}` ### `lucidmcp_lucid_fetch_item_image` Lucid Fetch Item Image · Read-only Fetch the source image attached to a specific item in a Lucid document. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `item_id` (`string`, required): No description. Example input: `{"document_id":"","item_id":""}` ### `lucidmcp_lucid_get_document_metadata` Lucid Get Document Metadata · Read-only Get metadata, access details, and owner information for a Lucid document. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `document_id` (`string`, required): No description. Example input: `{"document_id":""}` ### `lucidmcp_lucid_list_folder_contents` Lucid List Folder Contents · Read-only List the documents and subfolders inside a Lucid folder. Omit folder_id to list the root folder. Read only: yes. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `folder_id` (`string`, optional): No description. - `page_size` (`integer`, optional): No description. Default: `50`. - `page_token` (`string`, optional): No description. Example input: `{}` ### `lucidmcp_lucid_list_integrations` Lucid List Integrations · Read-only List the user's available third-party card integrations (e.g. Jira) and their connection status. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: none. Example input: `{}` ### `lucidmcp_lucid_search_document` Lucid Search Document · Read-only Locate regions of a Lucid document that contain specific text, returning page/region indexes you can pass to lucidmcp_fetch. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `id` (`string`, required): No description. - `queries` (`array`, required): No description. Example input: `{"id":"","queries":[]}` ### `lucidmcp_lucid_shape_details` Lucid Shape Details · Read-only Get default size, colors, and text-area/advanced properties for one or more Lucid shape classes. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `class_names` (`array`, required): No description. - `document_id` (`string`, required): No description. Example input: `{"class_names":[],"document_id":""}` ### `lucidmcp_lucid_shape_library` Lucid Shape Library · Read-only Discover shapes/blocks available to insert into a Lucid document, by library, group, or search term. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `group_ids` (`string`, optional): No description. - `library_id` (`string`, optional): No description. - `page_token` (`string`, optional): No description. - `search_term` (`string`, optional): No description. Example input: `{"document_id":""}` ### `lucidmcp_search` Search · Read-only Search for Lucid documents by keyword with optional filters for product type and date range. Returns up to 200 results. Read only: yes. Destructive: no. Idempotent (safe to retry): no. Inputs: - `query` (`string`, required): No description. - `created_end_time` (`string`, optional): No description. - `created_start_time` (`string`, optional): No description. - `last_modified_after` (`string`, optional): No description. - `owned_by_me` (`string`, optional): No description. - `product` (`string`, optional): No description. Example input: `{"query":""}` ### `lucidmcp__lucid_create_embed` Lucid Create Embed · Write Create an embed for a Lucid document. Internal tool for MCP Apps extension only. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. Example input: `{"document_id":""}` ### `lucidmcp__lucid_create_embed_session_token` Lucid Create Embed Session Token · Write Create a session token for an existing Lucid embed. Internal tool for MCP Apps extension only. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `embed_id` (`string`, required): No description. - `origin` (`string`, required): No description. - `page_id` (`string`, optional): No description. Example input: `{"embed_id":"","origin":""}` ### `lucidmcp_lucid_add_block` Lucid Add Block · Write Add a new shape or block to a Lucid document with optional position, size, text, and style properties. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `block_type` (`string`, required): No description. - `document_id` (`string`, required): No description. - `auto_font_size` (`string`, optional): No description. - `bold` (`string`, optional): No description. - `container_id` (`string`, optional): No description. - `fill_color` (`string`, optional): No description. - `font_family` (`string`, optional): No description. - `font_size` (`string`, optional): No description. - `height` (`string`, optional): No description. - `highlight_color` (`string`, optional): No description. - `italic` (`string`, optional): No description. - `line_color` (`string`, optional): No description. - `line_width` (`string`, optional): No description. - `link` (`string`, optional): No description. - `page_id` (`string`, optional): No description. - `rotation` (`string`, optional): No description. - `strike` (`string`, optional): No description. - `stroke_style` (`string`, optional): No description. - `subscript` (`string`, optional): No description. - `superscript` (`string`, optional): No description. - `text` (`string`, optional): No description. - `text_align` (`string`, optional): No description. - `text_areas` (`string`, optional): No description. - `text_color` (`string`, optional): No description. - `text_v_align` (`string`, optional): No description. - `underline` (`string`, optional): No description. - `width` (`string`, optional): No description. - `x` (`number`, optional): No description. Default: `0`. - `y` (`number`, optional): No description. Default: `0`. Example input: `{"block_type":"","document_id":""}` ### `lucidmcp_lucid_add_dynamic_table` Lucid Add Dynamic Table · Write Add an empty dynamic table (grid/matrix/kanban-style) to a Lucid document. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `columns` (`string`, optional): No description. - `page_id` (`string`, optional): No description. - `rows` (`string`, optional): No description. - `x` (`number`, optional): No description. Default: `0`. - `y` (`number`, optional): No description. Default: `0`. Example input: `{"document_id":""}` ### `lucidmcp_lucid_add_items_to_dynamic_table` Lucid Add Items To Dynamic Table · Write Add existing canvas blocks to a dynamic table; the table groups them into rows/columns based on each block's pivot field. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `block_ids` (`array`, required): No description. - `document_id` (`string`, required): No description. - `generator_id` (`string`, required): No description. Example input: `{"block_ids":[],"document_id":"","generator_id":""}` ### `lucidmcp_lucid_add_line` Lucid Add Line · Write Add a new line or connector to a Lucid document, optionally linking two shapes. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `bold` (`string`, optional): No description. - `endpoint1_auto_link` (`string`, optional): No description. - `endpoint1_position_x` (`string`, optional): No description. - `endpoint1_position_y` (`string`, optional): No description. - `endpoint1_shape_id` (`string`, optional): No description. - `endpoint1_style` (`string`, optional): No description. - `endpoint1_x` (`string`, optional): No description. - `endpoint1_y` (`string`, optional): No description. - `endpoint2_auto_link` (`string`, optional): No description. - `endpoint2_position_x` (`string`, optional): No description. - `endpoint2_position_y` (`string`, optional): No description. - `endpoint2_shape_id` (`string`, optional): No description. - `endpoint2_style` (`string`, optional): No description. - `endpoint2_x` (`string`, optional): No description. - `endpoint2_y` (`string`, optional): No description. - `font_family` (`string`, optional): No description. - `font_size` (`string`, optional): No description. - `highlight_color` (`string`, optional): No description. - `italic` (`string`, optional): No description. - `line_color` (`string`, optional): No description. - `line_shape` (`string`, optional): No description. - `line_width` (`string`, optional): No description. - `page_id` (`string`, optional): No description. - `strike` (`string`, optional): No description. - `stroke_style` (`string`, optional): No description. - `subscript` (`string`, optional): No description. - `superscript` (`string`, optional): No description. - `text` (`string`, optional): No description. - `text_color` (`string`, optional): No description. - `underline` (`string`, optional): No description. Example input: `{"document_id":""}` ### `lucidmcp_lucid_create_diagram_from_specification` Lucid Create Diagram From Specification · Write Create a Lucid document from a Standard Import JSON specification (.lucid file format). Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `product` (`string`, required): No description. - `standard_import_json` (`string`, required): No description. - `title` (`string`, required): No description. - `use_assisted_layout` (`boolean`, optional): No description. Default: `true`. Example input: `{"product":"","standard_import_json":"","title":""}` ### `lucidmcp_lucid_create_document_share_link` Lucid Create Document Share Link · Write Generate a share link for a Lucid document with configurable permissions and optional expiry. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `role` (`string`, required): No description. - `allow_anonymous` (`boolean`, optional): No description. Default: `false`. - `expires` (`string`, optional): No description. - `restrict_to_account` (`boolean`, optional): No description. Default: `true`. Example input: `{"document_id":"<document_id>","role":"<role>"}` ### `lucidmcp_lucid_create_erd` Lucid Create Erd · Write Create a Lucid document containing a data-backed Entity Relationship Diagram (ERD) from structured entity and relationship definitions. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `entities` (`array`, required): No description. - `relationships` (`array`, required): No description. - `title` (`string`, required): No description. - `product` (`string`, optional): No description. Default: `lucidchart`. Example input: `{"entities":[],"relationships":[],"title":"<title>"}` ### `lucidmcp_lucid_create_folder` Lucid Create Folder · Write Create a new folder in the user's Lucid account. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `name` (`string`, required): No description. - `folder_type` (`string`, optional): No description. Default: `folder`. - `parent` (`string`, optional): No description. Example input: `{"name":"<name>"}` ### `lucidmcp_lucid_create_mind_map` Lucid Create Mind Map · Write Create a Lucid document containing a mind map from structured node data. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `nodes` (`array`, required): No description. - `title` (`string`, required): No description. - `product` (`string`, optional): No description. Default: `lucidchart`. Example input: `{"nodes":[],"title":"<title>"}` ### `lucidmcp_lucid_create_org_chart` Lucid Create Org Chart · Write Create a Lucidchart document containing an org chart from a list of nodes with parent relationships. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `nodes` (`array`, required): No description. - `title` (`string`, required): No description. Example input: `{"nodes":[],"title":"<title>"}` ### `lucidmcp_lucid_create_sequence_diagram` Lucid Create Sequence Diagram · Write Create a Lucid document containing a UML sequence diagram from PlantUML markup. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `markup` (`string`, required): No description. - `product` (`string`, required): No description. - `title` (`string`, required): No description. Example input: `{"markup":"<markup>","product":"<product>","title":"<title>"}` ### `lucidmcp_lucid_import_integration_cards` Lucid Import Integration Cards · Write Import records from a connected third-party integration (e.g. Jira) into a Lucid document as linked cards. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `instance_id` (`string`, required): No description. - `integration_id` (`string`, required): No description. - `record_keys` (`array`, required): No description. - `layout` (`string`, optional): No description. Default: `grid`. - `page_id` (`string`, optional): No description. - `x` (`number`, optional): No description. Default: `0`. - `y` (`number`, optional): No description. Default: `0`. Example input: `{"document_id":"<document_id>","instance_id":"<instance_id>","integration_id":"<integration_id>","record_keys":[]}` ### `lucidmcp_lucid_submit_feedback` Lucid Submit Feedback · Write Submit user feedback, a bug report, or a feature request about the Lucid MCP server to Lucid's product team. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `feedback` (`string`, required): No description. - `title` (`string`, required): No description. Example input: `{"feedback":"<feedback>","title":"<title>"}` ### `lucidmcp_post_document_thread_comment` Post Document Thread Comment · Write Post a new comment to an existing collaboration thread on a Lucid document. Read only: no. Destructive: no. Idempotent (safe to retry): no. Inputs: - `content` (`string`, required): No description. - `document_id` (`string`, required): No description. - `thread_id` (`string`, required): No description. Example input: `{"content":"<content>","document_id":"<document_id>","thread_id":"<thread_id>"}` ### `lucidmcp_share_document_with_collaborators` Share Document With Collaborators · Write Share a Lucid document with collaborators by granting them access via email. Read only: no. Destructive: no. Idempotent (safe to retry): yes. Inputs: - `document_id` (`string`, required): No description. - `emails` (`array`, required): No description. - `role` (`string`, optional): No description. Default: `editandshare`. Example input: `{"document_id":"<document_id>","emails":[]}` ### `lucidmcp_lucid_delete_items` Lucid Delete Items · Destructive Delete one or more blocks or lines from a Lucid document by item ID. Read only: no. Destructive: yes. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `item_ids` (`array`, required): No description. Example input: `{"document_id":"<document_id>","item_ids":[]}` ### `lucidmcp_lucid_edit_dynamic_table_metadata` Lucid Edit Dynamic Table Metadata · Destructive Edit the reactive settings of an existing dynamic table: capacity-planning/load-tracking toggles and row/column group-by fields. Read only: no. Destructive: yes. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `generator_id` (`string`, required): No description. - `column_group_by_field` (`string`, optional): No description. - `enable_agile_capacity_planning` (`string`, optional): No description. - `row_group_by_field` (`string`, optional): No description. - `show_load_tracking_graphic` (`string`, optional): No description. Example input: `{"document_id":"<document_id>","generator_id":"<generator_id>"}` ### `lucidmcp_lucid_edit_item` Lucid Edit Item · Destructive Edit an existing block or line in a Lucid document — update position, size, text, or style. Read only: no. Destructive: yes. Idempotent (safe to retry): no. Inputs: - `document_id` (`string`, required): No description. - `item_id` (`string`, required): No description. - `auto_font_size` (`string`, optional): No description. - `bold` (`string`, optional): No description. - `clear_link` (`boolean`, optional): No description. Default: `false`. - `endpoint1_position_x` (`string`, optional): No description. - `endpoint1_position_y` (`string`, optional): No description. - `endpoint1_shape_id` (`string`, optional): No description. - `endpoint1_style` (`string`, optional): No description. - `endpoint1_x` (`string`, optional): No description. - `endpoint1_y` (`string`, optional): No description. - `endpoint2_position_x` (`string`, optional): No description. - `endpoint2_position_y` (`string`, optional): No description. - `endpoint2_shape_id` (`string`, optional): No description. - `endpoint2_style` (`string`, optional): No description. - `endpoint2_x` (`string`, optional): No description. - `endpoint2_y` (`string`, optional): No description. - `fill_color` (`string`, optional): No description. - `font_family` (`string`, optional): No description. - `font_size` (`string`, optional): No description. - `height` (`string`, optional): No description. - `highlight_color` (`string`, optional): No description. - `italic` (`string`, optional): No description. - `line_color` (`string`, optional): No description. - `line_shape` (`string`, optional): No description. - `line_width` (`string`, optional): No description. - `link` (`string`, optional): No description. - `locked` (`string`, optional): No description. - `rotation` (`string`, optional): No description. - `strike` (`string`, optional): No description. - `stroke_style` (`string`, optional): No description. - `subscript` (`string`, optional): No description. - `superscript` (`string`, optional): No description. - `text` (`string`, optional): No description. - `text_align` (`string`, optional): No description. - `text_areas` (`string`, optional): No description. - `text_color` (`string`, optional): No description. - `text_v_align` (`string`, optional): No description. - `underline` (`string`, optional): No description. - `width` (`string`, optional): No description. - `x` (`string`, optional): No description. - `y` (`string`, optional): No description. Example input: `{"document_id":"<document_id>","item_id":"<item_id>"}` ### `lucidmcp_lucid_update_document` Lucid Update Document · Destructive Update a Lucid document's title, parent folder, or custom tags. At least one of title, parent, or custom_tags must be provided. Read only: no. Destructive: yes. Idempotent (safe to retry): yes. Inputs: - `document_id` (`string`, required): No description. - `custom_tags` (`string`, optional): No description. - `parent` (`string`, optional): No description. - `title` (`string`, optional): No description. Example input: `{"document_id":"<document_id>"}` ### `lucidmcp_lucid_update_folder` Lucid Update Folder · Destructive Rename a Lucid folder or move it to a different parent. At least one of name or parent must be provided. Read only: no. Destructive: yes. Idempotent (safe to retry): yes. Inputs: - `folder_id` (`integer`, required): No description. - `name` (`string`, optional): No description. - `parent` (`string`, optional): No description. Example input: `{"folder_id":1}` ## Related Other Design connectors ([all 18](/agentkit/connectors/?category=design)): - [Figma](/agentkit/connectors/figma/): Scalekit connector, OAuth, 54 tools - [Miro](/agentkit/connectors/miro/): Scalekit connector, OAuth, 115 tools - [Brandfetch MCP server](/agentkit/connectors/brandfetchmcp/): Vendor MCP, OAuth, 7 tools --- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |