ci/woodpecker/push/woodpecker Pipeline was successful

Details

fix: accurate tool listings and signatures in all 6 MCP READMEs

- forgejo: verified against package tools/list (30 tools)
- semaphore: full rewrite with 50+ actual tools & signatures (was listing
  nonexistent tools like create_view, missing 30+ real tools)
- github: complete tool listing (35 tools) instead of vague placeholder
- portainer: full tool listing (32 tools) with params instead of vague list
- woodpecker: already accurate (verified against package, 33 tools)
- postgresql: already accurate (5 tools)

All tools verified against actual packages via tools/list RPC calls
or source code inspection.

2026-06-21 18:23:29 +02:00

5.8 KiB

Raw Blame History

semaphore-mcp

MCP server for SemaphoreUI Ansible automation.

Source: cloin/semaphore-mcp (v1.0.4)

Environment Variables

Variable	Required	Description
`SEMAPHORE_URL`	Yes	Base URL of the SemaphoreUI instance (e.g. `https://semaphore.corentic.eu`)
`SEMAPHORE_TOKEN`	Yes	API token from SemaphoreUI user settings
`MCP_PORT`	No	Port for the MCP HTTP server (default: `8000`)
`MCP_TRANSPORT`	No	Transport mode (`http` or `stdio`, default: `http`)
`MCP_HOST`	No	Bind address (default: `0.0.0.0`)

Usage

docker run -d \
  --name semaphore-mcp \
  -p 8103:8103 \
  -e SEMAPHORE_URL=https://semaphore.corentic.eu \
  -e SEMAPHORE_TOKEN=your_token \
  forgejo.corentic.eu/corentic/mcp-fleet-semaphore:latest

This MCP uses HTTP transport natively (no mcp-proxy wrapper). Connect via:

http://host:8103/mcp

Tools

Projects

list_projects — List all projects
get_project — Get project details. Params: project_id
create_project — Create project. Params: name, alert, alert_chat, max_parallel_tasks, project_type, demo
update_project — Update project. Params: project_id, name, alert, alert_chat, max_parallel_tasks
delete_project — Delete project. Params: project_id

Templates

list_templates — List templates. Params: project_id
get_template — Get template. Params: project_id, template_id
create_template — Create template. Params: project_id, name, playbook, inventory_id, repository_id, environment_id, description, arguments, allow_override_args_in_task, suppress_success_alerts, app, git_branch, survey_vars, vaults, template_type, start_version, build_template_id, autorun, view_id, task_params
update_template — Update template. Params: project_id, template_id, plus same fields as create
delete_template — Delete template. Params: project_id, template_id
stop_all_template_tasks — Stop all running tasks for a template. Params: project_id, template_id

Schedules

list_schedules — List schedules. Params: project_id
list_template_schedules — List schedules per template. Params: project_id, template_id
get_schedule — Get schedule. Params: project_id, schedule_id
create_schedule — Create schedule. Params: project_id, template_id, name, cron_format, active, schedule_type ("" for cron or "run_at"), run_at, task_params, delete_after_run, repository_id
update_schedule — Update schedule. Params: project_id, schedule_id, plus same fields as create
set_schedule_active — Enable/disable schedule. Params: project_id, schedule_id, active
delete_schedule — Delete schedule. Params: project_id, schedule_id
validate_schedule_cron_format — Validate cron expression. Params: project_id, cron_format

Tasks

list_tasks — List tasks. Params: project_id, limit, status, tags
get_task — Get task details. Params: project_id, task_id
run_task — Run task from template. Params: template_id, project_id, environment, limit, dry_run, diff, debug, playbook, git_branch, message, arguments, inventory_id, follow
get_latest_failed_task — Most recent failed task. Params: project_id
filter_tasks — Filter tasks by criteria. Params: project_id, status, limit, use_last_tasks
stop_task — Stop running task. Params: project_id, task_id
bulk_stop_tasks — Stop multiple tasks. Params: project_id, task_ids, confirm
get_waiting_tasks — List all waiting tasks. Params: project_id
get_task_raw_output — Get task raw output. Params: project_id, task_id
analyze_task_failure — Analyze failed task. Params: project_id, task_id
bulk_analyze_failures — Analyze multiple failed tasks. Params: project_id, limit

Environments

list_environments — List environments. Params: project_id
get_environment — Get environment. Params: project_id, environment_id
create_environment — Create environment. Params: project_id, name, env_data
update_environment — Update environment. Params: project_id, environment_id, name, env_data
delete_environment — Delete environment. Params: project_id, environment_id

Inventory

list_inventory — List inventory. Params: project_id
get_inventory — Get inventory item. Params: project_id, inventory_id
create_inventory — Create inventory. Params: project_id, name, inventory_data, inventory_type
update_inventory — Update inventory. Params: project_id, inventory_id, name, inventory_data, inventory_type
delete_inventory — Delete inventory. Params: project_id, inventory_id

Repositories

list_repositories — List repos. Params: project_id
get_repository — Get repo. Params: project_id, repository_id
create_repository — Create repo. Params: project_id, name, git_url, git_branch, ssh_key_id
update_repository — Update repo. Params: project_id, repository_id, name, git_url, git_branch, ssh_key_id
delete_repository — Delete repo. Params: project_id, repository_id

Access Keys

list_access_keys — List access keys. Params: project_id
create_access_key — Create access key. Params: project_id, name, key_type (none/ssh/login_password), login, password, private_key
delete_access_key — Delete access key. Params: project_id, key_id

5.8 KiB Raw Blame History