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

What you can do

Connect this agent connector to let your agent:

• List workspaces, workflows, files — Lists Latch workspaces the current user can access
• Workflow launch — Launch a bioinformatics workflow on Latch
• Get workflow schema, task logs, file — Fetch the launch metadata and parameter schema for a workflow

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.

latchbiomcp_get_execution#Fetch the status, task nodes, and results for a workflow execution. If a workflow errors, use get_task_logs to retrieve logs for failed tasks. Supports paginating through execution nodes and map-task shards.9 params▾

Fetch the status, task nodes, and results for a workflow execution. If a workflow errors, use get_task_logs to retrieve logs for failed tasks. Supports paginating through execution nodes and map-task shards.

NameTypeRequiredDescription

execution_idintegerrequiredLatch execution id returned by launch_workflow.

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

execution_node_cursorstringoptionalOpaque cursor from execution_nodes.next_cursor.

execution_node_limitintegeroptionalMax execution nodes to return, from 1 to 500. Default 100.

map_task_cursorstringoptionalOpaque cursor from a previous map-task page. Requires map_task_execution_node_id.

map_task_execution_node_idstringoptionalOptional execution node id whose map-task shard list should be paginated with map_task_cursor.

map_task_limitintegeroptionalMax map-task shards to return per map execution node, from 1 to 500. Default 100.

result_cursorstringoptionalOpaque pagination cursor from a previous results.next_cursor.

result_limitintegeroptionalMax result files to return, from 1 to 100. Default 25.

latchbiomcp_get_file#Return access information for a file stored in Latch Data. Returns either a Latch Console link or a presigned download URL depending on the access mode.3 params▾

Return access information for a file stored in Latch Data. Returns either a Latch Console link or a presigned download URL depending on the access mode.

NameTypeRequiredDescription

pathstringrequiredLatch Data URL, for example `latch://3800.account/results/output.csv`.

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

accessstringoptional`console` returns a Console link. `download` returns a presigned file download URL.

latchbiomcp_get_task_logs#Fetch or share logs for a workflow task execution. Returns bounded inline log lines by default, or a presigned download URL for full logs when mode is download_url.8 params▾

Fetch or share logs for a workflow task execution. Returns bounded inline log lines by default, or a presigned download URL for full logs when mode is download_url.

NameTypeRequiredDescription

execution_idintegerrequiredLatch execution id.

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

array_attemptstringoptionalOptional array task retry attempt.

array_indexstringoptionalOptional array task index.

modestringoptional`inline` returns bounded log lines. `download_url` returns a presigned URL for downloading the full task log when available.

task_attemptstringoptionalOptional task retry attempt.

task_idstringoptionalOptional workflow task/node id. Required for mode='download_url' and usually available for standard tasks.

task_run_idstringoptionalOptional process-style task run id.

latchbiomcp_get_workflow_schema#Fetch the launch metadata and parameter schema for a workflow. Use this before launching a workflow to understand what parameters are required and their types.2 params▾

Fetch the launch metadata and parameter schema for a workflow. Use this before launching a workflow to understand what parameters are required and their types.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

workflow_idintegerrequiredLatch workflow id.

latchbiomcp_launch_workflow#Launch a bioinformatics workflow on Latch. Use get_workflow_schema first to discover required parameters. Returns an execution ID for monitoring progress with list_executions and get_execution.6 params▾

Launch a bioinformatics workflow on Latch. Use get_workflow_schema first to discover required parameters. Returns an execution ID for monitoring progress with list_executions and get_execution.

NameTypeRequiredDescription

parametersobjectrequiredParameter values matching the workflow schema from get_workflow_schema.

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

workflow_idintegerrequiredWorkflow id to launch.

regionstringoptionalAWS region for workflow runtime placement. Options: us-west-2, us-east-1, eu-central-1, eu-west-1.

src_execution_idstringoptionalOptional previous execution id to relaunch from. Use only when intentionally reusing the previous execution's runtime storage/intermediate state. Omit for a normal fresh run.

workspace_idstringoptionalOptional workspace/account id that should own the execution. Defaults to the user's default workspace. Leave null unless the user asks to use a specific workspace.

latchbiomcp_list_executions#List workflow executions in a Latch workspace. Supports filtering by workflow IDs, execution status, and name. Use get_execution for full details on a specific execution.7 params▾

List workflow executions in a Latch workspace. Supports filtering by workflow IDs, execution status, and name. Use get_execution for full details on a specific execution.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

limitintegeroptionalMax executions to return, from 1 to 100. Default 25.

name_filterstringoptionalOptional display-name substring filter.

offsetintegeroptionalRow offset for pagination. Default 0.

statusesstringoptionalOptional execution statuses to restrict results to.

workflow_idsstringoptionalOptional workflow ids to restrict results to.

workspace_idstringoptionalOptional workspace/account id whose executions should be listed. Defaults to the user's default workspace. Leave null unless the user asks to use a specific workspace.

latchbiomcp_list_files#List the immediate contents of a directory in Latch Data (ldata). Returns children only — does not recurse. Hidden and removed nodes are filtered out, matching what users see in the Latch console. Supports cursor-based pagination.4 params▾

List the immediate contents of a directory in Latch Data (ldata). Returns children only — does not recurse. Hidden and removed nodes are filtered out, matching what users see in the Latch console. Supports cursor-based pagination.

NameTypeRequiredDescription

pathstringrequiredLatch Data URL, for example `latch://3800.account/dir1/foo`.

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

cursorstringoptionalOpaque pagination cursor from a previous response's `next_cursor`.

limitintegeroptionalMax entries to return per call (1-1000). Default 100.

latchbiomcp_list_workflows#Discover available bioinformatics workflows on Latch. Lists workspace-specific workflows first, followed by public workflows. Supports text search and cursor-based pagination.5 params▾

Discover available bioinformatics workflows on Latch. Lists workspace-specific workflows first, followed by public workflows. Supports text search and cursor-based pagination.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

cursorstringoptionalOpaque pagination cursor from a previous response's `next_cursor`.

limitintegeroptionalMax workflows to return, from 1 to 100. Default 25.

search_termstringoptionalOptional case-insensitive display-name substring filter.

workspace_idstringoptionalOptional workspace/account id. Defaults to the user's default workspace when omitted. Leave null unless the user asks to use a specific workspace.

latchbiomcp_list_workspaces#Lists Latch workspaces the current user can access. Returns the default workspace ID and a list of all accessible workspaces with their IDs and display names. If default_workspace_id is null, the user has not finished account setup.1 param▾

Lists Latch workspaces the current user can access. Returns the default workspace ID and a list of all accessible workspaces with their IDs and display names. If default_workspace_id is null, the user has not finished account setup.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool