Connect AI agents to the Semaphore CI MCP server

1. Install the SDK

   Section titled “Install the SDK”
   • Node.js
   • Python

   1
   npm install @scalekit-sdk/node dotenv

   Full SDK reference: Node.js | Python

2. Set your credentials

   Section titled “Set your credentials”

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   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

   Section titled “Authorize and make your first call”
   • Node.js
   • Python

   1
   import { ScalekitClient } from '@scalekit-sdk/node'
   2
   import 'dotenv/config'
   3
   import { createInterface } from 'node:readline/promises'
   4
   
   5
   const scalekit = new ScalekitClient(
   6
     process.env.SCALEKIT_ENVIRONMENT_URL,
   7
     process.env.SCALEKIT_CLIENT_ID,
   8
     process.env.SCALEKIT_CLIENT_SECRET,
   9
   )
   10
   const actions = scalekit.actions
   11
   
   12
   const connector = 'semaphorecimcp'
   13
   const identifier = 'user_123'
   14
   
   15
   // Generate an authorization link for the user
   16
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   17
   console.log('Authorize Semaphore CI MCP:', link)
   18
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   19
   await rl.question('Press Enter after authorizing...')
   20
   rl.close()
   21
   
   22
   // Make your first call
   23
   const result = await actions.executeTool({
   24
     connector,
   25
     identifier,
   26
     toolName: 'semaphorecimcp_organizations_list',
   27
     toolInput: {},
   28
   })
   29
   console.log(result)

   1
   npx tsx quickstart.mts

Connect this agent connector to let your agent:

• Search workflows, projects, docs — Search recent Semaphore CI workflows for a project, most recent first
• Run workflows, tasks — Schedule a new Semaphore CI workflow run for a project
• Rerun workflows — Rerun an existing Semaphore CI workflow
• List tasks, projects, pipelines — List scheduled tasks (periodics) for a Semaphore CI project
• Describe tasks, jobs — Get detailed information about a Semaphore CI scheduled task (periodic)
• Jobs pipeline — List all jobs in a Semaphore CI pipeline

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.