Complete reference of all acs_* MCP tools, organized by category with their access levels. All tools are prefixed with acs_* when called by agents.
| Tool | Description |
|---|---|
| create_work | Create a new task with similar-task warnings |
| claim_work | Claim a task — returns guidance packet |
| release_work | Release a task — returns feedback prompt |
| lock_file | Lock a file before editing |
| unlock_file | Unlock a file (single or all for a task) |
| get_present_status | See what all agents are working on |
| get_locked_files | See all currently locked files |
| list_tasks | List tasks with optional status filter |
| sleep | Put agent to sleep until a task arrives |
| wake | Manually wake a sleeping agent |
| help | Comprehensive reference of all MCP tools |
| Tool | Description |
|---|---|
| save_memory | Save an eternal truth as knowledge memory |
| query_memories | Search and list memories with optional filters and hybrid search |
| set_memory_status | Update a memory's status (approve/reject/stale/deprecated) |
| generate_guidance_packet | Get structured guidance for a scope path |
| Tool | Level | Description |
|---|---|---|
| cognition_get | 1 | Get the full spec for a module |
| cognition_search | 1 | Full-text search across cognition specs |
| cognition_list | 1 | List all cognition specs |
| cognition_list_undocumented | 1 | Scan for modules without specs |
| cognition_propose | 2 | Propose a new spec or update existing |
| cognition_approve | 2 | Approve a proposed spec |
| cognition_reject | 2 | Soft-reject a proposed spec |
| Tool | Description |
|---|---|
| config_lookup | Look up opencode/ACS configuration settings |
| connection_diagnostic | Check if external services are reachable |
| query_memories | Hybrid search (semantic + FTS) across memories |
| memory_health_check | Check health of the memory system |
| get_logs | Retrieve application logs with filtering |
| Tool | Description |
|---|---|
| list_error_traces | List persistent error traces with filters |
| ack_error_trace | Acknowledge an error trace (being investigated) |
| resolve_error_trace | Mark an error trace as resolved |
| create_task_from_error_trace | Create investigation task from error |
| Tool | Level | Description |
|---|---|---|
| write_tool | 1 | Register a new MCP tool dynamically |
| refresh_tools | 1 | Force reload tool definitions |
| list_orgs | 1 | List all organizations from configured apps |
| time | 3 | Get or set ACS time offset (testing) |
| exec_command | 1 | Execute a shell command (restricted by ALLOWED_COMMANDS) |
| app_configure | 1 | Add or update a configured external app at runtime |
| app_list | 1 | List all configured external apps |
| app_remove | 1 | Remove a configured external app |
| sleep | 1 | Put agent to sleep until a task arrives |
| wake | 1 | Manually wake a sleeping agent |
Tools are defined in YAML files. Create {app}.yaml and hot-reload:
app: my_app
tools:
- name: my_tool
description: "Description of my tool"
handler: ""
endpoint: "http://my-service:8080/api/my-tool"
category: custom
level: 1
inputSchema:
type: object
properties:
param1:
type: string
description: "..."Then call acs_refresh_tools() to load without restart.