MCP tools
The 83 tools the plugin's MCP server exposes, group by group, with what each does and whether it is granted, pack-gated or always asks.
In short
This page is the lookup for the plugin's tools: what each does, and whether it runs freely, runs once its pack is on, or asks every time. Read the permission classes first, since every group below names one.
Every tool the plugin's server gives the agent, one row each. In permission lists a tool's name carries the prefix mcp__plugin_agentlayer_agent__.
Permission classes
Each group below says which of these four classes its tools are in.
| Class | Meaning | Where it lives |
|---|---|---|
| Core | Granted at setup, in every home | permissions.allow |
| Pack | Granted when you switch the pack on in configure-skills. Until then it prompts on use | permissions.allow |
| Asks | Always waits for your yes, in every permission mode: seed_import, curl_run, github_pr_create | permissions.ask |
| Prompts | Never granted, so your host asks each time: list_worktrees, remove_worktree | Nowhere, on purpose |
The server refuses an Asks tool while its ask rule is missing. A tool that a plugin update adds can't run unseen before upgrade writes the rule.
settings.json lists only the packs you opted into, so it stays an accurate record of what the agent may do.
Tasks (7)
Each task carries a horizon: the day, week or month it is planned for. See Tasks. All Core.
| Tool | Does |
|---|---|
task_query | Lists tasks across projects, filtered by status, priority, project, assignee or lane (carried, today, week, month, later) |
task_get | Reads one task in full: frontmatter, description, checklist, thread |
task_create | Creates a task. A description is required |
task_update | Updates a task's fields, checks the status change is allowed, and returns the fields it wrote |
task_close | Closes a task as done |
task_thread | Appends a message to a task's thread |
task_scan | Unblocks and blocks tasks by their dependencies, and surfaces overdue, due-soon and stale ones |
Knowledge (7)
The compile_* tools return prompts. Your session does the synthesis, and compile_write confirms it. See The brain. All Core.
| Tool | Does |
|---|---|
capture | Saves a thought, snippet, file or URL to the inbox, or a correction to the feedback log. See Capture |
compile_status | Counts what is waiting to compile: sessions, feedback, inbox |
compile_next | Returns the next item to compile, with its prompt and source |
compile_write | Marks a compiled item complete |
knowledge_lint | Checks the wiki's structure: broken links, orphans, missing backlinks, invalid frontmatter. Can fix links and backlinks |
links_rewrite | Turns bare task ids and shorthand into wikilinks |
memory_prune | Deletes daily memory older than 14 days |
Reports and surfaces (3)
All Core.
| Tool | Does |
|---|---|
report_write | Writes a report under reports/ and adds its line to reports/index.md in the same call. The category is the plugin's or any kebab-case folder of your own (not captures); an .html report is written as it is, with no frontmatter |
dashboard | Rebuilds projects/TASKS.md and dashboard.html, then this home's entry in the cmux sidebar, and returns how the sidebar went (written, unchanged, not-installed, not-joined or failed). See Dashboard |
attention_write | Renders the attention view (the dashboard's Today view, or one project's page) and returns the same JSON the page embeds. See Attention |
Worktrees (3)
See Worktrees.
| Tool | Does | Granted |
|---|---|---|
setup_worktree | Creates a sibling git worktree and bootstraps it: copies local files, installs, builds | Core |
list_worktrees | Audits every worktree of a repo with a verdict. Read-only | Prompts |
remove_worktree | Removes a worktree. Refuses one with uncommitted changes, and one on a base branch | Prompts |
Upgrade and hosts (2)
All Core.
| Tool | Does |
|---|---|
run_upgrade | Runs a release's one-time migration outside the sandbox. See Upgrades |
codex_setup | Writes or refreshes the home's Codex wiring. See Codex |
History (1)
All Core.
| Tool | Does |
|---|---|
home_history | Reports on the home's version history, turns it on, and puts back a .git link a synced folder deleted. It writes only for a history it set up. See History |
Seed (3)
See Seed bundles.
| Tool | Does | Granted |
|---|---|---|
seed_scan | Lists what this home could hand to a teammate. Read-only | Core |
seed_export | Builds a seed bundle from the selection you approved | Core |
seed_import | Overlays a bundle onto this home: it can overwrite identity files and merges permissions and MCP registrations | Asks |
Database (4)
The three reads run inside a BEGIN READ ONLY transaction with a statement timeout, then roll back, so Postgres itself rejects a write. See Database pack. All Pack.
| Tool | Does |
|---|---|
database_list | Lists the configured connections, never their credentials |
database_schema | Lists tables, or describes one table's columns |
database_query | Runs a read-only SQL query. A secret column is checked with aggregates only |
database_fork | The one write: clones a local database with CREATE DATABASE … TEMPLATE … for risky schema work |
GitHub (18)
Each tool wraps the gh CLI with the token of the repo's owner. Nothing merges, closes an issue, re-runs a workflow or edits someone else's text. See GitHub pack. All Pack, except github_pr_create.
| Tool | Does |
|---|---|
github_pr_list | Lists pull requests, filtered by author, a pending review request or a search query. One call finds your PRs, another the reviews you owe |
github_pr_view | One pull request in full |
github_pr_comments | Every comment on a PR, inline review threads included |
github_pr_diff | A PR's diff, or only its changed files |
github_pr_checks | The state of every check on a PR |
github_run_list | Lists workflow runs |
github_run_view | One run, job by job and step by step |
github_run_log | A run's logs, failed steps only by default |
github_issue_list | Lists issues |
github_issue_view | One issue in full |
github_sweep | Everything waiting on you in one call: owed comments, review requests, re-reviews, pending reviews and conflicting PRs, decided from GitHub's own fields. With counts: true it returns only the numbers, which is how sync reads it |
github_fast_forward | The one git write: a forward-only fetch of your local default branches during sync |
github_issue_create | Opens an issue, with screenshots or videos attached |
github_issue_comment | Comments on an issue, with attachments |
github_issue_update | Changes an issue's title, description, labels or milestone |
github_pr_update | Replaces a PR's title or description |
github_comment_update | Fixes a comment the token's own account wrote |
github_pr_create | Opens a pull request from a pushed branch. The one Asks tool here |
Helpdesk (9)
One shape for SupportCandy and Pylon. Every tool but helpdesk_connections takes a connection to pick a site or workspace. See Helpdesk. All Pack.
| Tool | Does |
|---|---|
helpdesk_connections | Lists the configured sites and workspaces |
helpdesk_tickets | Lists recently updated tickets with the people on each: customer and assignee |
helpdesk_ticket | One ticket with its whole conversation, each message with its author |
helpdesk_attachment | Saves a ticket's log or screenshot to a temp folder outside the home |
helpdesk_accounts | Lists customer companies |
helpdesk_lookups | Lists reference data: statuses, categories, tags, teammates, macros |
helpdesk_stats | Counts a queue's tickets in a window. Numbers only, never ticket text, which is why sync can run it |
helpdesk_note | A write: a private note that agents see and the customer never does, for a draft reply a person sends |
helpdesk_assign | A write: sets a SupportCandy ticket's assignee and reads it back to confirm the change |
App Store (1)
All Pack.
| Tool | Does |
|---|---|
appstore_reviews | Reads any app's reviews from Apple's public feed, newest first, per country storefront. It never replies. See App Store |
How appstore_reviews reads the feed:
- It learns which storefronts an app's reviews come from.
- It asks again when Apple's cache hands back a blank page.
- It marks a read incomplete when a storefront that has had reviews comes back blank.
- It gives no count when nothing came back, never zero.
- A limit of
0returns the counts alone, which is how sync can run it.
Slack (7)
The tools read Slack as you, with a user token that has no write or DM scope. See Slack. All Pack.
| Tool | Does |
|---|---|
slack_whoami | Checks the sign-in and returns who you are |
slack_channels | Lists the channels you are a member of |
slack_history | Recent messages from one channel |
slack_batch_history | Recent messages from many channels in one call |
slack_thread | One thread in full |
slack_search | Searches messages across the workspace |
slack_waiting | What is waiting on you: unanswered mentions, threads in shared channels where someone outside the workspace spoke last, and channels the channel map doesn't list. It returns who, where, how long and a link, never message text |
Browser (6)
See Browser. All Pack.
| Tool | Does |
|---|---|
browser_screenshot | A PNG of a URL or a local HTML or Markdown file |
browser_pdf | A URL or local file as a PDF |
browser_markdown | Renders a page so its scripts run, then saves the article body as Markdown |
browser_record | Drives a browser through scripted steps and returns a video |
browser_flows | Runs one of your flows in a visible browser |
web_search | A direct call to the Perplexity Search API: ranked results with title, link, snippet and date |
SEO (8)
See SEO. All Pack.
| Tool | Does |
|---|---|
serpapi_search | Live Google results. Each call costs one SerpAPI unit |
open_page_rank | Domain authority for up to 100 domains |
google_auth | The one-time Google sign-in the next five tools need |
gsc_sites | Lists the Search Console sites your account can read |
gsc_query | Search analytics rows for the configured site |
gsc_inspect | One URL's indexing status |
page_speed_psi | PageSpeed score and Core Web Vitals for one URL, mobile or desktop |
page_speed_audit | The same for mobile and desktop together |
Utilities (4)
| Tool | Does | Granted |
|---|---|---|
curl_run | Fires one request with a collection's secrets filled in, and leaves the machine. See API collections | Asks |
video_frames | Extracts stills from a local recording | Core |
media_transcribe | Turns a recording's speech into a timestamped transcript on the Mac itself (macOS 26 or later, needs yap). See the media skill in Skills | Core |
ping | Health check: the server's status, the plugin version it loaded, and the paths it resolved | Core |
How the server runs
- Outside the shell sandbox. That is how it reads the secrets store the agent's own shell is denied, shells out to
gh, and makes the git writes a worktree needs. - GitHub tokens. A tool uses
GITHUB_TOKEN_<OWNER>for the repo's owner, elseGITHUB_TOKEN, else your owngh auth login. The token's permissions decide what a write may do. - Slack's token is read by the server; your shell can't read it.
run_upgradeoptions. An optionaloptionsobject passes the choices you made inupgradeto the migration.install: truewithpluginRootrunsbun installin the version folder the upgrade loaded from: the server's own plugin folder or a sibling version of it, and nothing else.
Cancelling a call
Cancelling a call stops what it started, and each of these also has a timeout:
- worktree setup's install and build;
run_upgrade's install;media_transcribeandvideo_frames;browser_flows;- the
ghandgitcalls the GitHub tools make.
Writes that must not stop halfway take only their timeout: removing a worktree, deleting a branch, a home migration, and the Codex wiring.
Everything but gh and git starts as its own process group. The whole group goes down, with anything it started, when the call finishes, times out, is cancelled or the server exits.