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.

NameTypeRequiredDescription

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

NameTypeRequiredDescription

embed_idstringrequiredNo description.

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

NameTypeRequiredDescription

idstringrequiredNo description.

page_indexstringoptionalNo description.

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

block_typestringrequiredNo description.

document_idstringrequiredNo description.

boldstringoptionalNo description.

container_idstringoptionalNo description.

fill_colorstringoptionalNo description.

font_familystringoptionalNo description.

font_sizestringoptionalNo description.

heightstringoptionalNo description.

highlight_colorstringoptionalNo description.

italicstringoptionalNo description.

line_colorstringoptionalNo description.

line_widthstringoptionalNo description.

page_idstringoptionalNo description.

rotationstringoptionalNo description.

strikestringoptionalNo description.

stroke_stylestringoptionalNo description.

subscriptstringoptionalNo description.

superscriptstringoptionalNo description.

textstringoptionalNo description.

text_alignstringoptionalNo description.

text_colorstringoptionalNo description.

text_v_alignstringoptionalNo description.

underlinestringoptionalNo description.

widthstringoptionalNo description.

xnumberoptionalNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

boldstringoptionalNo description.

endpoint1_auto_linkstringoptionalNo description.

endpoint1_position_xstringoptionalNo description.

endpoint1_position_ystringoptionalNo description.

endpoint1_shape_idstringoptionalNo description.

endpoint1_stylestringoptionalNo description.

endpoint1_xstringoptionalNo description.

endpoint1_ystringoptionalNo description.

endpoint2_auto_linkstringoptionalNo description.

endpoint2_position_xstringoptionalNo description.

endpoint2_position_ystringoptionalNo description.

endpoint2_shape_idstringoptionalNo description.

endpoint2_stylestringoptionalNo description.

endpoint2_xstringoptionalNo description.

endpoint2_ystringoptionalNo description.

font_familystringoptionalNo description.

font_sizestringoptionalNo description.

highlight_colorstringoptionalNo description.

italicstringoptionalNo description.

line_colorstringoptionalNo description.

line_shapestringoptionalNo description.

line_widthstringoptionalNo description.

page_idstringoptionalNo description.

strikestringoptionalNo description.

stroke_stylestringoptionalNo description.

subscriptstringoptionalNo description.

superscriptstringoptionalNo description.

textstringoptionalNo description.

text_colorstringoptionalNo description.

underlinestringoptionalNo 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).

NameTypeRequiredDescription

productstringrequiredNo description.

standard_import_jsonstringrequiredNo description.

titlestringrequiredNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

rolestringrequiredNo description.

allow_anonymousbooleanoptionalNo description.

expiresstringoptionalNo description.

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

NameTypeRequiredDescription

nodesarrayrequiredNo description.

titlestringrequiredNo description.

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

NameTypeRequiredDescription

nodesarrayrequiredNo description.

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

NameTypeRequiredDescription

markupstringrequiredNo description.

productstringrequiredNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

item_idstringrequiredNo description.

boldstringoptionalNo description.

endpoint1_position_xstringoptionalNo description.

endpoint1_position_ystringoptionalNo description.

endpoint1_shape_idstringoptionalNo description.

endpoint1_xstringoptionalNo description.

endpoint1_ystringoptionalNo description.

endpoint2_position_xstringoptionalNo description.

endpoint2_position_ystringoptionalNo description.

endpoint2_shape_idstringoptionalNo description.

endpoint2_xstringoptionalNo description.

endpoint2_ystringoptionalNo description.

fill_colorstringoptionalNo description.

font_familystringoptionalNo description.

font_sizestringoptionalNo description.

heightstringoptionalNo description.

highlight_colorstringoptionalNo description.

italicstringoptionalNo description.

line_colorstringoptionalNo description.

line_widthstringoptionalNo description.

rotationstringoptionalNo description.

strikestringoptionalNo description.

stroke_stylestringoptionalNo description.

subscriptstringoptionalNo description.

superscriptstringoptionalNo description.

textstringoptionalNo description.

text_alignstringoptionalNo description.

text_colorstringoptionalNo description.

text_v_alignstringoptionalNo description.

underlinestringoptionalNo description.

widthstringoptionalNo description.

xstringoptionalNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

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

NameTypeRequiredDescription

querystringrequiredNo description.

created_end_timestringoptionalNo description.

created_start_timestringoptionalNo description.

last_modified_afterstringoptionalNo description.

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

NameTypeRequiredDescription

document_idstringrequiredNo description.

emailsarrayrequiredNo description.

rolestringoptionalNo description.