KosmoKrator

productivity

Semaphore CI MCP Gateway for AI Agents

Expose Semaphore CI tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Semaphore CI MCP Gateway

Expose Semaphore CI to MCP clients with `kosmokrator mcp:serve --integration=semaphore-ci`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=semaphore-ci --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-semaphore-ci": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=semaphore-ci",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=semaphore-ci --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__semaphore_ci__semaphore_ci_run_workflow semaphore-ci.semaphore_ci_run_workflow Write write
integration__semaphore_ci__semaphore_ci_get_workflow semaphore-ci.semaphore_ci_get_workflow Read read
integration__semaphore_ci__semaphore_ci_list_workflows semaphore-ci.semaphore_ci_list_workflows Read read
integration__semaphore_ci__semaphore_ci_rerun_workflow semaphore-ci.semaphore_ci_rerun_workflow Write write
integration__semaphore_ci__semaphore_ci_stop_workflow semaphore-ci.semaphore_ci_stop_workflow Write write
integration__semaphore_ci__semaphore_ci_get_pipeline semaphore-ci.semaphore_ci_get_pipeline Read read
integration__semaphore_ci__semaphore_ci_list_pipelines semaphore-ci.semaphore_ci_list_pipelines Read read
integration__semaphore_ci__semaphore_ci_stop_pipeline semaphore-ci.semaphore_ci_stop_pipeline Write write
integration__semaphore_ci__semaphore_ci_partial_rebuild_pipeline semaphore-ci.semaphore_ci_partial_rebuild_pipeline Write write
integration__semaphore_ci__semaphore_ci_validate_yaml semaphore-ci.semaphore_ci_validate_yaml Write write
integration__semaphore_ci__semaphore_ci_list_promotions semaphore-ci.semaphore_ci_list_promotions Read read
integration__semaphore_ci__semaphore_ci_trigger_promotion semaphore-ci.semaphore_ci_trigger_promotion Write write
integration__semaphore_ci__semaphore_ci_trigger_task semaphore-ci.semaphore_ci_trigger_task Write write
integration__semaphore_ci__semaphore_ci_get_job semaphore-ci.semaphore_ci_get_job Read read
integration__semaphore_ci__semaphore_ci_stop_job semaphore-ci.semaphore_ci_stop_job Write write
integration__semaphore_ci__semaphore_ci_get_job_logs semaphore-ci.semaphore_ci_get_job_logs Read read
integration__semaphore_ci__semaphore_ci_list_agent_types semaphore-ci.semaphore_ci_list_agent_types Read read
integration__semaphore_ci__semaphore_ci_create_agent_type semaphore-ci.semaphore_ci_create_agent_type Write write
integration__semaphore_ci__semaphore_ci_update_agent_type semaphore-ci.semaphore_ci_update_agent_type Write write
integration__semaphore_ci__semaphore_ci_get_agent_type semaphore-ci.semaphore_ci_get_agent_type Read read
integration__semaphore_ci__semaphore_ci_delete_agent_type semaphore-ci.semaphore_ci_delete_agent_type Write write
integration__semaphore_ci__semaphore_ci_disable_agent_type_agents semaphore-ci.semaphore_ci_disable_agent_type_agents Write write
integration__semaphore_ci__semaphore_ci_list_agents semaphore-ci.semaphore_ci_list_agents Read read
integration__semaphore_ci__semaphore_ci_get_agent semaphore-ci.semaphore_ci_get_agent Read read
integration__semaphore_ci__semaphore_ci_list_deployment_targets semaphore-ci.semaphore_ci_list_deployment_targets Read read
integration__semaphore_ci__semaphore_ci_get_deployment_target semaphore-ci.semaphore_ci_get_deployment_target Read read
integration__semaphore_ci__semaphore_ci_create_deployment_target semaphore-ci.semaphore_ci_create_deployment_target Write write
integration__semaphore_ci__semaphore_ci_update_deployment_target semaphore-ci.semaphore_ci_update_deployment_target Write write
integration__semaphore_ci__semaphore_ci_delete_deployment_target semaphore-ci.semaphore_ci_delete_deployment_target Write write
integration__semaphore_ci__semaphore_ci_deactivate_deployment_target semaphore-ci.semaphore_ci_deactivate_deployment_target Write write
integration__semaphore_ci__semaphore_ci_activate_deployment_target semaphore-ci.semaphore_ci_activate_deployment_target Write write
integration__semaphore_ci__semaphore_ci_get_deployment_history semaphore-ci.semaphore_ci_get_deployment_history Read read
integration__semaphore_ci__semaphore_ci_list_artifacts semaphore-ci.semaphore_ci_list_artifacts Read read
integration__semaphore_ci__semaphore_ci_get_artifact_signed_url semaphore-ci.semaphore_ci_get_artifact_signed_url Read read
integration__semaphore_ci__semaphore_ci_configure_artifact_retention_policy semaphore-ci.semaphore_ci_configure_artifact_retention_policy Write write
integration__semaphore_ci__semaphore_ci_get_artifact_retention_policy semaphore-ci.semaphore_ci_get_artifact_retention_policy Read read
integration__semaphore_ci__semaphore_ci_api_get semaphore-ci.semaphore_ci_api_get Read read
integration__semaphore_ci__semaphore_ci_api_post semaphore-ci.semaphore_ci_api_post Write write
integration__semaphore_ci__semaphore_ci_api_patch semaphore-ci.semaphore_ci_api_patch Write write
integration__semaphore_ci__semaphore_ci_api_delete semaphore-ci.semaphore_ci_api_delete Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.