AgentLayer▸docs
Reference

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.

ClassMeaningWhere it lives
CoreGranted at setup, in every homepermissions.allow
PackGranted when you switch the pack on in configure-skills. Until then it prompts on usepermissions.allow
AsksAlways waits for your yes, in every permission mode: seed_import, curl_run, github_pr_createpermissions.ask
PromptsNever granted, so your host asks each time: list_worktrees, remove_worktreeNowhere, 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.

ToolDoes
task_queryLists tasks across projects, filtered by status, priority, project, assignee or lane (carried, today, week, month, later)
task_getReads one task in full: frontmatter, description, checklist, thread
task_createCreates a task. A description is required
task_updateUpdates a task's fields, checks the status change is allowed, and returns the fields it wrote
task_closeCloses a task as done
task_threadAppends a message to a task's thread
task_scanUnblocks 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.

ToolDoes
captureSaves a thought, snippet, file or URL to the inbox, or a correction to the feedback log. See Capture
compile_statusCounts what is waiting to compile: sessions, feedback, inbox
compile_nextReturns the next item to compile, with its prompt and source
compile_writeMarks a compiled item complete
knowledge_lintChecks the wiki's structure: broken links, orphans, missing backlinks, invalid frontmatter. Can fix links and backlinks
links_rewriteTurns bare task ids and shorthand into wikilinks
memory_pruneDeletes daily memory older than 14 days

Reports and surfaces (3)

All Core.

ToolDoes
report_writeWrites 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
dashboardRebuilds 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_writeRenders 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.

ToolDoesGranted
setup_worktreeCreates a sibling git worktree and bootstraps it: copies local files, installs, buildsCore
list_worktreesAudits every worktree of a repo with a verdict. Read-onlyPrompts
remove_worktreeRemoves a worktree. Refuses one with uncommitted changes, and one on a base branchPrompts

Upgrade and hosts (2)

All Core.

ToolDoes
run_upgradeRuns a release's one-time migration outside the sandbox. See Upgrades
codex_setupWrites or refreshes the home's Codex wiring. See Codex

History (1)

All Core.

ToolDoes
home_historyReports 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.

ToolDoesGranted
seed_scanLists what this home could hand to a teammate. Read-onlyCore
seed_exportBuilds a seed bundle from the selection you approvedCore
seed_importOverlays a bundle onto this home: it can overwrite identity files and merges permissions and MCP registrationsAsks

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.

ToolDoes
database_listLists the configured connections, never their credentials
database_schemaLists tables, or describes one table's columns
database_queryRuns a read-only SQL query. A secret column is checked with aggregates only
database_forkThe 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.

ToolDoes
github_pr_listLists 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_viewOne pull request in full
github_pr_commentsEvery comment on a PR, inline review threads included
github_pr_diffA PR's diff, or only its changed files
github_pr_checksThe state of every check on a PR
github_run_listLists workflow runs
github_run_viewOne run, job by job and step by step
github_run_logA run's logs, failed steps only by default
github_issue_listLists issues
github_issue_viewOne issue in full
github_sweepEverything 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_forwardThe one git write: a forward-only fetch of your local default branches during sync
github_issue_createOpens an issue, with screenshots or videos attached
github_issue_commentComments on an issue, with attachments
github_issue_updateChanges an issue's title, description, labels or milestone
github_pr_updateReplaces a PR's title or description
github_comment_updateFixes a comment the token's own account wrote
github_pr_createOpens 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.

ToolDoes
helpdesk_connectionsLists the configured sites and workspaces
helpdesk_ticketsLists recently updated tickets with the people on each: customer and assignee
helpdesk_ticketOne ticket with its whole conversation, each message with its author
helpdesk_attachmentSaves a ticket's log or screenshot to a temp folder outside the home
helpdesk_accountsLists customer companies
helpdesk_lookupsLists reference data: statuses, categories, tags, teammates, macros
helpdesk_statsCounts a queue's tickets in a window. Numbers only, never ticket text, which is why sync can run it
helpdesk_noteA write: a private note that agents see and the customer never does, for a draft reply a person sends
helpdesk_assignA write: sets a SupportCandy ticket's assignee and reads it back to confirm the change

App Store (1)

All Pack.

ToolDoes
appstore_reviewsReads 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 0 returns 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.

ToolDoes
slack_whoamiChecks the sign-in and returns who you are
slack_channelsLists the channels you are a member of
slack_historyRecent messages from one channel
slack_batch_historyRecent messages from many channels in one call
slack_threadOne thread in full
slack_searchSearches messages across the workspace
slack_waitingWhat 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.

ToolDoes
browser_screenshotA PNG of a URL or a local HTML or Markdown file
browser_pdfA URL or local file as a PDF
browser_markdownRenders a page so its scripts run, then saves the article body as Markdown
browser_recordDrives a browser through scripted steps and returns a video
browser_flowsRuns one of your flows in a visible browser
web_searchA direct call to the Perplexity Search API: ranked results with title, link, snippet and date

SEO (8)

See SEO. All Pack.

ToolDoes
serpapi_searchLive Google results. Each call costs one SerpAPI unit
open_page_rankDomain authority for up to 100 domains
google_authThe one-time Google sign-in the next five tools need
gsc_sitesLists the Search Console sites your account can read
gsc_querySearch analytics rows for the configured site
gsc_inspectOne URL's indexing status
page_speed_psiPageSpeed score and Core Web Vitals for one URL, mobile or desktop
page_speed_auditThe same for mobile and desktop together

Utilities (4)

ToolDoesGranted
curl_runFires one request with a collection's secrets filled in, and leaves the machine. See API collectionsAsks
video_framesExtracts stills from a local recordingCore
media_transcribeTurns a recording's speech into a timestamped transcript on the Mac itself (macOS 26 or later, needs yap). See the media skill in SkillsCore
pingHealth check: the server's status, the plugin version it loaded, and the paths it resolvedCore

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, else GITHUB_TOKEN, else your own gh 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_upgrade options. An optional options object passes the choices you made in upgrade to the migration. install: true with pluginRoot runs bun install in 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_transcribe and video_frames;
  • browser_flows;
  • the gh and git calls 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.

On this page