Available Tools

The full list of 20 tools your coding agent can use through the Hamster MCP server.

Overview

When your agent connects to the Hamster MCP server, it gains access to 20 tools organized across six areas: accounts, briefs, tasks, subtasks, documents, and plans. These tools let the agent read your project context, create and update work items, and navigate between accounts — all scoped to your permissions.

Accounts

Tool What it does
list_accounts Show all your accounts (personal and team)
switch_account Switch to a different account

Briefs

Tool What it does
list_briefs List briefs in the current account
get_brief Get a brief's full content and metadata
create_brief Create a new brief
update_brief Update a brief's title, description, or status
delete_brief Delete a brief

Tasks

Tool What it does
list_tasks List tasks for a brief, with optional filters for status, priority, and assignee
get_task Get a task's full details including subtasks and dependencies
create_task Create a new task under a brief
update_task Update a task's title, description, priority, assignee, or other fields
update_task_status Move a task to a new status (to do, in progress, done)
get_next_task Get the next task to work on based on priority and dependencies

Subtasks

Tool What it does
list_subtasks List subtasks for a task
create_subtask Add a subtask to a task
update_subtask Update a subtask's content or status
delete_subtask Remove a subtask

Documents

Tool What it does
list_documents List documents attached to a brief
get_document Get a document's full content

Plans

Tool What it does
get_plan Get the full plan for a brief, including all generated tasks

Tips

  • get_next_task is particularly useful for agentic workflows. It returns the highest-priority task that has no unfinished dependencies — so the agent always picks up the right thing next.
  • get_task accepts both UUIDs and display IDs (like HAM-123), so your agent can reference tasks the same way you do.
  • list_tasks supports filters for status, priority, and assignee — useful when you want the agent to focus on a specific slice of work.
  • update_task_status handles reordering automatically. When the agent moves a task to "done", the task list stays correctly sorted.

Related