MCP Tool Catalog
Complete schema reference for the AMOF Control Plane MCP server. Every tool maps to an existing REST endpoint, CLI command, or service function.
Legend
| Column | Meaning |
|---|---|
| Scope | global = no ecosystem needed; ecosystem = requires name; run = requires run_id; release = release pipeline |
| Mode | read-only = no side effects; safe-write = reversible mutation; dangerous-write = destructive or pushes to remote |
| Confirm | Whether the MCP client should prompt the user before executing |
Global Scope
amof_list_ecosystems
| Field | Value |
|---|---|
| Scope | global |
| Mode | read-only |
| Confirm | no |
| Description | List all ecosystems with repo counts, KB/journal stats, and active task counts |
amof_get_server_status
| Field | Value |
|---|---|
| Scope | global |
| Mode | read-only |
| Confirm | no |
| Description | Check whether the AMOF Control Plane API server is running, return PID and uptime |
amof_get_active_runs
| Field | Value |
|---|---|
| Scope | global |
| Mode | read-only |
| Confirm | no |
| Description | List all runs across ecosystems, optionally filtered by status |
amof_get_global_telemetry
| Field | Value |
|---|---|
| Scope | global |
| Mode | read-only |
| Confirm | no |
| Description | Aggregated telemetry: total runs, cost totals, average durations, active count |
amof_switch_ecosystem
| Field | Value |
|---|---|
| Scope | global |
| Mode | safe-write |
| Confirm | no |
| Description | Set the current active ecosystem context for the MCP session |
Ecosystem Scope
All ecosystem-scoped tools accept ecosystem as a required string parameter.
Read-Only Tools
| Tool | Description |
|---|---|
| amof_get_ecosystem_status | Repo-level status: branch, commit, mode, dirty/unpushed flags, active ticket |
| amof_describe_ecosystem | Full metadata: name, path, repos, KB count, journal count, index time |
| amof_validate_manifest | Validate ecosystem YAML manifest schema |
| amof_ticket_list | List all tracked tickets with branch mappings |
Safe-Write Tools
| Tool | Mode | Description |
|---|---|---|
| amof_sync_ecosystem | safe-write | Sync all repos from remote origins |
| amof_ticket_start | safe-write | Create feature branches for a new ticket |
| amof_ticket_switch | safe-write | Switch to a different active ticket |
| amof_ticket_end | safe-write | End ticket work, optionally clean up branches |
| amof_create_journal | safe-write | Create a journal entry in the ecosystem directory |
Dangerous-Write Tools
| Tool | Confirm | Description |
|---|---|---|
| amof_install_ecosystem | yes | Bootstrap workspace: create worktree, clone repos |
| amof_push_ecosystem | yes | Push workspace + repo feature branches to remote |
| amof_spin_deploy | yes | Deploy infrastructure via provisioner |
| amof_spin_destroy | yes | Destroy all infrastructure (irreversible) |
| amof_archive_ecosystem | yes | Archive workspace: push, save state, delete branch |
| amof_discard_ecosystem | yes | Discard workspace entirely (irreversible) |
Run Scope
| Tool | Mode | Description |
|---|---|---|
| amof_list_runs | read-only | List all runs |
| amof_get_run_status | read-only | Get run details |
| amof_get_run_logs | read-only | Stream/get run logs |
| amof_summarize_run | read-only | Generate run summary |
Release Scope
| Tool | Mode | Confirm | Description |
|---|---|---|---|
| amof_release_status | read-only | no | Current version and available bumps |
| amof_release_log | read-only | no | Release history from audit trail |
| amof_release_validate | read-only | no | Validate release readiness |
| amof_release_bump | dangerous-write | yes | Bump version (commits, tags, pushes) |
| amof_release_promote | dangerous-write | yes | Promote pre-release stage |
Server Scope
| Tool | Mode | Description |
|---|---|---|
| amof_server_start | safe-write | Start the control plane server |
| amof_server_stop | safe-write | Stop the server |
| amof_server_restart | safe-write | Restart the server |