Connect AI agents to the Mobbin MCP server

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node dotenv

   Python

   pip install scalekit-sdk-python python-dotenv

   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.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 = 'mobbinmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Mobbin 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: 'mobbinmcp_search_sections',
     toolInput: { query: 'YOUR_QUERY' },
   })
   console.log(result)

   npx tsx quickstart.mts

   Python

   quickstart.py

   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 = "mobbinmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Mobbin MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"query":"YOUR_QUERY"},
       tool_name="mobbinmcp_search_sections",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

   python quickstart.py

What you can do

Connect this agent connector to let your agent:

• Search sections, screens, flows — Search Mobbin for website sections (e.g

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.

mobbinmcp_search_flows#Search Mobbin for multi-step user flows (e.g. onboarding, checkout) using natural language. Returns flow screens with inline images.5 params▾

Search Mobbin for multi-step user flows (e.g. onboarding, checkout) using natural language. Returns flow screens with inline images.

NameTypeRequiredDescription

platformstringrequiredPlatform to filter results by.

querystringrequiredNatural language query to search for user flows.

image_formatstringoptionalFormat for the returned flow screen images.

limitintegeroptionalMaximum number of results to return.

pageintegeroptionalPage number for pagination.

mobbinmcp_search_screens#Search Mobbin for UI screens using natural language. Returns matching screens with inline images and metadata.6 params▾

Search Mobbin for UI screens using natural language. Returns matching screens with inline images and metadata.

NameTypeRequiredDescription

platformstringrequiredPlatform to filter results by.

querystringrequiredNatural language query to search for UI screens.

exclude_screen_idsarrayoptionalList of screen IDs to exclude from results.

image_formatstringoptionalFormat for the returned screen images.

limitintegeroptionalMaximum number of results to return.

modestringoptionalSearch mode to control result matching strategy.

mobbinmcp_search_sections#Search Mobbin for website sections (e.g. About, Pricing, Footer) using natural language. Returns section images from real websites.4 params▾

Search Mobbin for website sections (e.g. About, Pricing, Footer) using natural language. Returns section images from real websites.

NameTypeRequiredDescription

querystringrequiredNatural language query to search for website sections.

image_formatstringoptionalFormat for the returned section images.

limitintegeroptionalMaximum number of results to return.

pageintegeroptionalPage number for pagination.