Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Artisto MCP server

Vendor MCP
Open markdown

The Artisto MCP connector routes your AI agent's tool calls to Artisto's own MCP server through Scalekit. Each user connects their own Artisto access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 81 tools.

Tools
81
What they doRead · write · destructive
34 · 33 · 1434 read33 write14 destructive
Users sign in with

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 Artisto MCP connection

    In AgentKit > Connections, create an Artisto MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

  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 = 'artistomcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Artisto 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: 'artistomcp_users_me',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Artisto MCP server credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • artistomcp_billing_stateGet the caller's billing state from Polar: active subscriptions, granted benefits, and isPro (holds the Pro benefit).Read-only

    Get Billing State

    Get the caller's billing state from Polar: active subscriptions, granted benefits, and isPro (holds the Pro benefit). When billing is off it answers id "noop" with nothing active.

    Inputs

    This tool takes no inputs.

  • artistomcp_chats_byidGet one of the caller's chats with its messages, oldest first, or null.Read-only

    Get Chat

    Get one of the caller's chats with its messages, oldest first, or null.

    Inputs

    idstringrequired
    ID of the chat to fetch.
  • artistomcp_chats_folderbyidGet one of the caller's chat folders by id, or null.Read-only

    Get Chat Folder

    Get one of the caller's chat folders by id, or null.

    Inputs

    idstringrequired
    ID of the chat folder to fetch.
  • artistomcp_chats_foldersList the caller's chat folders in their sort order.Read-only

    List Chat Folders

    List the caller's chat folders in their sort order.

    Inputs

    This tool takes no inputs.

  • artistomcp_chats_mineList the caller's chats without messages: pinned first, then most recently updated.Read-only

    List My Chats

    List the caller's chats without messages: pinned first, then most recently updated.

    Inputs

    This tool takes no inputs.

  • artistomcp_designs_appGet one of the caller's design apps by id with its brief and design system (theme CSS, DESIGN.md, fonts, devices, appearance), or null.Read-only

    Get Design App

    Get one of the caller's design apps by id with its brief and design system (theme CSS, DESIGN.md, fonts, devices, appearance), or null. Before designing, read designs_context too.

    Inputs

    idstringrequired
    UUID of the design app to fetch.
  • artistomcp_designs_appsList the caller's design apps, newest first.Read-only

    List Design Apps

    List the caller's design apps, newest first.

    Inputs

    This tool takes no inputs.

  • artistomcp_designs_appsystemGet one of the caller's apps by appId with its current design system, or null.Read-only

    Get App Design System

    Get one of the caller's apps by appId with its current design system, or null.

    Inputs

    appIdstringrequired
    UUID of the design app.