Semaphore Connector for AI agents.

36 live capabilities

Manage CI/CD pipelines and deployment targets using natural language.

Live agent request Semaphore / Connector

Waiting for input…

AI Agent

Why people use Semaphore

Semaphore CI/CD Pipeline Management for DevOps

With this Connector, you can check logs and status without ever leaving your workspace. You get a direct line to your delivery pipeline, keeping your focus where it belongs. You spend less time looking at status lights and more time actually shipping features.

What Vinkius changes

You get a command line for your CI/CD pipeline powered by natural language.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Debugging a failed build

A developer sees a failed build in their terminal and asks their agent to fetch logs for job 889900 to see exactly why it died.
Real-world use case 02

Promoting a release to production

A release manager asks the agent to trigger_promotion for the latest pipeline to the production target to finish a deployment.
Real-world use case 03

Auditing past deployments

A lead engineer asks the agent to show the deployment history of the staging target to see which version was last shipped.

Complete set · 36capabilities

The complete Semaphore capability set.

These are the exact actions your AI can choose when you ask it to work with Semaphore.

Capability set01 / 09

01—04

4 capabilities in this set.

Part of 36 available through Semaphore.

01 Capability
Delete deployment target
Delete a deployment target from your project. Use this to remove old or decommissioned targets.
02 Capability
Create agent type
Create a new self-hosted agent type for your organization. This helps you define how your agents behave.
03 Capability
Get workflow
See the details of a specific workflow. Use this to understand how a specific process is mapped.
04 Capability
List agent types
See all self-hosted agent types in your account. This gives you a high level view of your infrastructure.

Capability set02 / 09

05—08

4 capabilities in this set.

Part of 36 available through Semaphore.

05 Capability
Rerun workflow
Start a rerun for a specific workflow. Use this to try a failed task again without manual setup.
06 Capability
Run workflow
Trigger a brand new Semaphore workflow. This lets you start a new process with a single command.
07 Capability
Update agent type
Modify the settings for an existing agent type. Use this to change runner configurations on the fly.
08 Capability
Update deployment target
Change the details of a deployment target. This allows you to update your environment definitions.

Capability set03 / 09

09—12

4 capabilities in this set.

Part of 36 available through Semaphore.

09 Capability
Create deployment target
Set up a new target for your deployments. Use this to define where your code goes next.
10 Capability
Deactivate deployment target
Turn off a specific deployment target. This is useful for maintenance or rotating environments.
11 Capability
Delete agent type
Remove an existing self-hosted agent type. Clean up your configuration when types are no longer needed.
12 Capability
Disable all agent types
Turn off all agents of a specific type at once. This is a fast way to pause specific agent clusters.

Capability set04 / 09

13—16

4 capabilities in this set.

Part of 36 available through Semaphore.

13 Capability
Get agent
View details for a specific self-hosted agent. Use this to check the status of a single runner.
14 Capability
Get agent type
See the configuration for a specific agent type. This shows you the settings for your runner groups.
15 Capability
Get artifact retention
Check how long artifacts are kept for a project. This helps you manage your storage costs.
16 Capability
Get deployment history
View the history of deployments for a specific target. This is perfect for auditing past releases.

Capability set05 / 09

17—20

4 capabilities in this set.

Part of 36 available through Semaphore.

17 Capability
Get deployment target by name
Find a deployment target using its name. This makes it easier to identify targets in a large project.
18 Capability
Get deployment target
Look up a specific deployment target by its ID. Use this for precise targeting in your scripts.
19 Capability
Get job logs
Pull logs for a specific job to find errors. This saves you from scrolling through the dashboard.
20 Capability
Get job
Get the full description of a specific job. Use this to see the details of a single build task.

Capability set06 / 09

21—24

4 capabilities in this set.

Part of 36 available through Semaphore.

21 Capability
Get pipeline
View the details of a specific pipeline. This shows you the structure of your delivery flow.
22 Capability
List agents
List all agents grouped by their type. Use this to see which runners are currently active.
23 Capability
List artifacts
See all artifacts for a specific scope. This helps you track the files generated by your builds.
24 Capability
List deployment targets
See all deployment targets for a project. Use this to see all available environments for your app.

Capability set07 / 09

25—28

4 capabilities in this set.

Part of 36 available through Semaphore.

25 Capability
List pipelines
List all pipelines for a given project. This helps you see every available delivery path.
26 Capability
List promotions
View all promotions for a specific pipeline. Use this to track the progress of a release.
27 Capability
List workflows
List all workflows for a project. This gives you a full overview of your automated tasks.
28 Capability
Rebuild pipeline
Fix failed blocks in a pipeline automatically. This helps you recover from partial failures quickly.

Capability set08 / 09

29—32

4 capabilities in this set.

Part of 36 available through Semaphore.

29 Capability
Stop job
Stop a job that is currently running. Use this to kill a hung process or a build that is taking too long.
30 Capability
Stop pipeline
Stop a running pipeline immediately. This is your emergency brake for any active delivery flow.
31 Capability
Stop workflow
Stop a running workflow. Use this to halt a specific process that is no longer needed.
32 Capability
Trigger promotion
Start a promotion to a new environment. This is the primary way to move code to production.

Capability set09 / 09

33—36

4 capabilities in this set.

Part of 36 available through Semaphore.

33 Capability
Trigger task
Run a specific task right now. Use this for on-demand actions like cache clearing or manual tests.
34 Capability
Validate yaml
Check your pipeline YAML for syntax errors. Use this to catch mistakes before you push your code.
35 Capability
Activate deployment target
Turn on a specific deployment target. Use this to make a new environment available for use.
36 Capability
Configure artifact retention
Set how long your build artifacts stay in storage. This helps you manage your storage costs and organization.

Set up in minutes

One URL. Then ask Semaphore to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Semaphore from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Semaphore, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Semaphore for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Semaphore URL.
Step 03

Save and start

Save the connection and enable Semaphore in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "semaphore": {
      "url": "https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Semaphore

Open Agent mode in chat and ask: "Using Semaphore, help me...". 36 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "semaphore": {
      "url": "https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Semaphore

Ask Copilot: "Using Semaphore, help me...". 36 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "semaphore": {
      "url": "https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Semaphore

Open Cascade and ask: "Using Semaphore, help me...". 36 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "semaphore": {
      "url": "https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Semaphore

Ask Cline: "Using Semaphore, help me...". 36 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add semaphore --transport http "https://edge.vinkius.com/vk_preview_4boMMcM8niVqPugdtaODagPmB0iDjPIFB9fElanu/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Semaphore

Ask Claude: "Using Semaphore, show me...". 36 tools are ready

Where the request belongs

Work Semaphore can move forward.

Built around the request

This is for the DevOps engineer who is tired of clicking through dashboards at 2am or the developer who wants to see build logs without context switching.

01

DevOps Engineer

Monitors pipeline health and manages deployment targets via chat to stay updated on system status.

02

Software Developer

Checks build logs and triggers promotions directly from the code editor to maintain focus.

03

Release Manager

Orchestrates complex deployment sequences and audits history through simple queries.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 11 capabilities

Buildkite

Automate CI/CD pipelines via Buildkite. manage builds, agents, and deployments directly from any AI agent.

02 10 capabilities

Travis CI

Manage CI/CD pipelines, trigger custom builds, and oversee repository testing health securely via your AI agent.

03 11 capabilities

Harness

Automate CI/CD and DevOps workflows via Harness. manage pipelines, executions, and secrets directly from any AI agent.

04 34 capabilities

Woodpecker CI

Manage your Woodpecker CI instance. control pipelines, monitor agents, and configure repositories directly from your AI agent.

05 8 capabilities

Codefresh

Manage CI/CD and GitOps via Codefresh. track pipelines, trigger builds, and monitor delivery clusters directly from any AI agent.

06 39 capabilities

Drone CI

Automate your CI/CD workflows with Drone CI—manage repositories, monitor builds, and handle secrets directly from your AI agent.

Bring your own AI

Change the model, client or framework. Keep Semaphore connected.

Before you connect

Questions about Semaphore.

The practical details behind the request, access and result.

Can Semaphore MCP help me debug failed builds?

Yes, it lets you pull specific build logs directly into your chat. You can identify errors without leaving your editor.

How do I use Semaphore MCP to see my deployment history?

You can simply ask your agent to show the history for a specific target. It will list all past deployments and their statuses.

Can I trigger a production release using Semaphore MCP?

Yes, you can use it to trigger promotions to your production environment using natural language commands.

Does Semaphore MCP work with my existing CI/CD pipelines?

It connects directly to your existing Semaphore account, giving your agent control over your current workflows.

How can I manage my build artifacts with Semaphore MCP?

You can list artifacts for specific scopes and configure how long they are kept in your storage.

Can I check my pipeline YAML for errors using Semaphore MCP?

Yes, it includes a capability to validate your pipeline YAML definitions before you commit them, helping you catch syntax errors early.

Can I check the logs of a specific job to debug a failure?

Yes! Use the get_job_logs capability with the Job ID. Your agent will retrieve the execution logs, allowing you to identify errors directly in the conversation.

How do I list all active pipelines for a specific project?

Simply ask the agent to run the list_pipelines action providing the Project ID. You can also filter by branch name or workflow ID.

Is it possible to trigger a promotion to production via chat?

Yes. If your pipeline has promotions configured, you can use the trigger_promotion capability by providing the Promotion ID to move your code to the next stage.

One connection away

Give your agent a direct line to Semaphore.

Connect Semaphore once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available