Hex 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 = 'hexmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Hex 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: 'hexmcp_get_me',
     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 = "hexmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Hex MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="hexmcp_get_me",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Search projects — Search for Hex projects by keyword
• Get thread, me — Fetch a Hex Thread by its ID, including the latest response and status
• Create thread — Create a new Hex Thread to ask a question about your data using natural language
• Thread continue — Continue an existing Hex Thread by adding a new message and triggering the agent to process it

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.

hexmcp_continue_thread # Continue an existing Hex Thread by adding a new message and triggering the agent to process it. 2 params ▾

Continue an existing Hex Thread by adding a new message and triggering the agent to process it.

Name Type Required Description

id string required The ID of the thread to continue

prompt string required The message to add to continue the thread

hexmcp_create_thread # Create a new Hex Thread to ask a question about your data using natural language. 1 param ▾

Create a new Hex Thread to ask a question about your data using natural language.

Name Type Required Description

prompt string required No description.

hexmcp_get_me # Return information about the currently authenticated user. 0 params ▾

Return information about the currently authenticated user.

hexmcp_get_thread # Fetch a Hex Thread by its ID, including the latest response and status. 1 param ▾

Fetch a Hex Thread by its ID, including the latest response and status.

Name Type Required Description

id string required No description.

hexmcp_search_projects # Search for Hex projects by keyword. 1 param ▾

Search for Hex projects by keyword.

Name Type Required Description

query string required The search query to find relevant projects. This should be a non-empty string without wildcards.