Lucid MCP connector

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 = '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)
   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: 'lucidmcp_get_mcp_resource',
     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 = "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)

What you can do

Connect this agent connector to let your agent:

• Collaborators share document with — Share a Lucid document with collaborators by granting them access via email
• Search records — Search for Lucid documents by keyword with optional filters for product type and date range
• Fetch lucid — Fetch the source image attached to a specific item in a Lucid document
• Png lucid export document as — Export a page of a Lucid document as a PNG image
• Item lucid edit — Edit an existing block or line in a Lucid document — update position, size, text, or style
• Delete lucid — Delete one or more blocks or lines from a Lucid document by item ID

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.

lucidmcp__lucid_create_embed # Create an embed for a Lucid document. Internal tool for MCP Apps extension only. 1 param ▾

Create an embed for a Lucid document. Internal tool for MCP Apps extension only.

Name Type Required Description

document_id string required No description.

lucidmcp__lucid_create_embed_session_token # Create a session token for an existing Lucid embed. Internal tool for MCP Apps extension only. 2 params ▾

Create a session token for an existing Lucid embed. Internal tool for MCP Apps extension only.

Name Type Required Description

embed_id string required No description.

origin string required No description.

lucidmcp_fetch # Retrieve the structured content of a Lucid document by ID, including pages, blocks, and lines. 3 params ▾

Retrieve the structured content of a Lucid document by ID, including pages, blocks, and lines.

Name Type Required Description

id string required No description.

page_index string optional No description.

region_index string optional No description.

lucidmcp_get_mcp_resource # Read a resource from the Lucid MCP server by its URI. 1 param ▾

Read a resource from the Lucid MCP server by its URI.

Name Type Required Description

resource_uri string optional No description.

lucidmcp_lucid_add_block # Add a new shape or block to a Lucid document with optional position, size, text, and style properties. 26 params ▾

Add a new shape or block to a Lucid document with optional position, size, text, and style properties.

Name Type Required Description

block_type string required No description.

document_id string required 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.

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_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.

y number optional No description.

lucidmcp_lucid_add_line # Add a new line or connector to a Lucid document, optionally linking two shapes. 31 params ▾

Add a new line or connector to a Lucid document, optionally linking two shapes.

Name Type Required Description

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.

lucidmcp_lucid_create_diagram_from_specification # Create a Lucid document from a Standard Import JSON specification (.lucid file format). 4 params ▾

Create a Lucid document from a Standard Import JSON specification (.lucid file format).

Name Type Required Description

product string required No description.

standard_import_json string required No description.

title string required No description.

use_assisted_layout boolean optional No description.

lucidmcp_lucid_create_document_share_link # Generate a share link for a Lucid document with configurable permissions and optional expiry. 5 params ▾

Generate a share link for a Lucid document with configurable permissions and optional expiry.

Name Type Required Description

document_id string required No description.

role string required No description.

allow_anonymous boolean optional No description.

expires string optional No description.

restrict_to_account boolean optional No description.

lucidmcp_lucid_create_mind_map # Create a Lucid document containing a mind map from structured node data. 3 params ▾

Create a Lucid document containing a mind map from structured node data.

Name Type Required Description

nodes array required No description.

title string required No description.

product string optional No description.

lucidmcp_lucid_create_org_chart # Create a Lucidchart document containing an org chart from a list of nodes with parent relationships. 2 params ▾

Create a Lucidchart document containing an org chart from a list of nodes with parent relationships.

Name Type Required Description

nodes array required No description.

title string required No description.

lucidmcp_lucid_create_sequence_diagram # Create a Lucid document containing a UML sequence diagram from PlantUML markup. 3 params ▾

Create a Lucid document containing a UML sequence diagram from PlantUML markup.

Name Type Required Description

markup string required No description.

product string required No description.

title string required No description.

lucidmcp_lucid_delete_items # Delete one or more blocks or lines from a Lucid document by item ID. 2 params ▾

Delete one or more blocks or lines from a Lucid document by item ID.

Name Type Required Description

document_id string required No description.

item_ids array required No description.

lucidmcp_lucid_edit_item # Edit an existing block or line in a Lucid document — update position, size, text, or style. 34 params ▾

Edit an existing block or line in a Lucid document — update position, size, text, or style.

Name Type Required Description

document_id string required No description.

item_id string required No description.

bold 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_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_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_width 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_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.

lucidmcp_lucid_export_document_as_png # Export a page of a Lucid document as a PNG image. 2 params ▾

Export a page of a Lucid document as a PNG image.

Name Type Required Description

document_id string required No description.

page integer optional No description.

lucidmcp_lucid_fetch_item_image # Fetch the source image attached to a specific item in a Lucid document. 2 params ▾

Fetch the source image attached to a specific item in a Lucid document.

Name Type Required Description

document_id string required No description.

item_id string required No description.

lucidmcp_search # Search for Lucid documents by keyword with optional filters for product type and date range. Returns up to 200 results. 5 params ▾

Search for Lucid documents by keyword with optional filters for product type and date range. Returns up to 200 results.

Name Type Required Description

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.

product string optional No description.

lucidmcp_share_document_with_collaborators # Share a Lucid document with collaborators by granting them access via email. 3 params ▾

Share a Lucid document with collaborators by granting them access via email.

Name Type Required Description

document_id string required No description.

emails array required No description.

role string optional No description.