Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Lucid MCP server

Vendor MCP
Open markdown

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 41 tools.

Tools
41
What they doRead · write · destructive
13 · 23 · 513 read23 write5 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

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

    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

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • lucidmcp_fetchRetrieve the structured content of a Lucid document by ID, including pages, blocks, and lines.Read-only

    Fetch

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

    Inputs

    idstringrequired
    No description.
    metadata_onlystring
    No description.default false
    page_indexstring
    No description.
    region_indexstring
    No description.
  • lucidmcp_get_mcp_resourceRead a resource from the Lucid MCP server by its URI.Read-only

    Get Mcp Resource

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

    Inputs

    resource_uristring
    No description.default
  • lucidmcp_list_document_thread_commentsList comments on a specific collaboration thread of a Lucid document.Read-only

    List Document Thread Comments

    List comments on a specific collaboration thread of a Lucid document.

    Inputs

    document_idstringrequired
    No description.
    thread_idstringrequired
    No description.
  • lucidmcp_list_document_threadsList collaboration threads on a Lucid document.Read-only

    List Document Threads

    List collaboration threads on a Lucid document.

    Inputs

    document_idstringrequired
    No description.
  • lucidmcp_lucid_export_document_as_pngExport a page of a Lucid document as a PNG image.Read-only

    Lucid Export Document As PNG

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

    Inputs

    document_idstringrequired
    No description.
    bounding_boxstring
    No description.
    pageinteger
    No description.default 1
  • lucidmcp_lucid_fetch_item_imageFetch the source image attached to a specific item in a Lucid document.Read-only

    Lucid Fetch Item Image

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

    Inputs

    document_idstringrequired
    No description.
    item_idstringrequired
    No description.
  • lucidmcp_lucid_get_document_metadataGet metadata, access details, and owner information for a Lucid document.Read-only

    Lucid Get Document Metadata

    Get metadata, access details, and owner information for a Lucid document.

    Inputs

    document_idstringrequired
    No description.
  • lucidmcp_lucid_list_folder_contentsList the documents and subfolders inside a Lucid folder.Read-only

    Lucid List Folder Contents

    List the documents and subfolders inside a Lucid folder. Omit folder_id to list the root folder.

    Inputs

    folder_idstring
    No description.
    page_sizeinteger
    No description.default 50
    page_tokenstring
    No description.
All 22 in Design