Accounts, part 2 of 2 MCP tools

Your account's appearance, layouts, prompts, usage and limits, domains, client policies and monitor boards. These are 19 tools of the 38 tools of the accounts backend (part 2 of 2; the others are part 1); all MCP tools lists the other backends.

accounts_list_client_overridesCopy Anchor Link

List a client's overrides. The accounts and plans held to an older minimum of a client type until a date, with the reason and who set it. Setting and ending one is a person's act, in the console. The platform's admins only.

Scopes: mcp:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_client_overrides",
    "arguments": {}
  }
}

accounts_list_client_policiesCopy Anchor Link

List the clients' version policies. Every client type (ios, android, cli, agent, trails-ext, sdk-<language>) with its published policy (latest, minimum, grace deadline, security minimum, enforce, links, the words in en and hr, version, who published it and why) and its draft. The platform's admins only.

Scopes: mcp:read · reads only

No arguments.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_client_policies",
    "arguments": {}
  }
}

accounts_list_client_policy_eventsCopy Anchor Link

List a client policy's history. Every step on a client type's policy, newest first: drafted, review_requested, approved, rejected, scheduled, published, rolled_back, paused, resumed, auto_paused, override_set, override_removed, announcement_tested; who, whether an assistant, the version and a short note. The platform's admins only.

Scopes: mcp:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_client_policy_events",
    "arguments": {}
  }
}

accounts_list_client_policy_versionsCopy Anchor Link

List a client's published versions. A client type's published policy versions, newest first, each with who published it, when, why and the version a rollback put back. The platform's admins only.

Scopes: mcp:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_client_policy_versions",
    "arguments": {}
  }
}

accounts_list_domainsCopy Anchor Link

List domains. Domains: one DNS TXT record proves the account controls a domain; the proof gates single sign-on, agents and everything our cloud sends at a customer's systems. org_id is a team's id or the person's own account's. Reading takes a member's role or domains:read; adding, checking, confirming and removing take an admin's role or domains:write.

Scopes: mcp:read, domains:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_domains",
    "arguments": {}
  }
}

accounts_list_layoutsCopy Anchor Link

List dashboard layouts. The dashboard layouts the caller saved on an account, and the account's defaults: per page (overview, agent, local.overview), the boxes top to bottom with their width in columns of 12 (0 is the box's own) and whether each is hidden. org_id is the account (accounts_get_me names yours).

Scopes: mcp:read, account:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_layouts",
    "arguments": {}
  }
}

accounts_list_themesCopy Anchor Link

My colour themes. The colour themes you made, oldest first: id, name, base preset, and the colour of each token for light and dark (hex or oklch values).

Scopes: mcp:read · reads only

No arguments.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_themes",
    "arguments": {}
  }
}

accounts_list_unit_categoriesCopy Anchor Link

List unit categories. The categories and what one call in each costs.

Scopes: mcp:read, usage:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_unit_categories",
    "arguments": {}
  }
}

accounts_move_monitorsCopy Anchor Link

Move monitors to a category. Put up to 500 monitors (monitor_ids from connections_list_monitors) in a category, at its end or at position (1 is first); an empty category_id puts them back in their own category. The monitor and the agent's checks.toml keep their category; the board's placement wins on the monitors page. The owner or an admin.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_move_monitors",
    "arguments": {}
  }
}

accounts_preview_client_policyCopy Anchor Link

Preview a client policy's impact. What a draft would do now to the clients seen in the last 30 days: how many would be refused (agents, keys, people) in how many accounts, how many warned, how many held back by an override, and the refused ones by requests. Changes nothing. The platform's admins only.

Scopes: mcp:read · reads only

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_preview_client_policy",
    "arguments": {}
  }
}

accounts_save_client_policy_draftCopy Anchor Link

Draft a client's version policy. Save a client type's draft on the published version it was made from (base_version); a newer one published since is a conflict: read again. A draft goes live only after a second admin approved it and an admin published it, in the console. The words (headline, what's new, stop reason, release notes in markdown) are what people see in the app, the extension and the command line, in en and hr. A rollout (percent, accounts, plans, pause_over_refusals_per_hour) and the announcement (channels, lead_hours) are part of the draft.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_save_client_policy_draft",
    "arguments": {}
  }
}

accounts_save_monitor_categoryCopy Anchor Link

Make or change a monitor category. Make a category on the monitors page (empty category.id; a name of 1 to 40 characters and optionally a colour: slate, red, orange, amber, green, teal, blue, violet, pink), or rename or recolour one by its id, built in or the account's. The owner or an admin. Never deletes.

Scopes: mcp:write · changes something

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_save_monitor_category",
    "arguments": {}
  }
}

accounts_save_themeCopy Anchor Link

Save a colour theme. Make a colour theme (leave id empty) or replace one of yours (pass its id). Needs a name (1 to 60 characters), a base preset, and light and dark maps of token to colour; only the 25 known tokens (background, foreground, card, primary, border, sidebar and so on) and only #rgb, #rrggbb, #rrggbbaa or oklch(L C H) colours are accepted. At most 50 themes per person.

Scopes: mcp:write · changes something

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_save_theme",
    "arguments": {}
  }
}

accounts_set_appearanceCopy Anchor Link

Set my appearance. Set your colour mode (system, light or dark) and colour theme (a preset id, or custom:<theme id> for one of your own themes). Your own only; a theme that is not yours is not found. Every surface you sign in on shows it.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_appearance",
    "arguments": {}
  }
}

accounts_set_default_accountCopy Anchor Link

Set my default account. Make an account the signed-in person belongs to (their own or one of their teams) their default, the one every new sign-in opens on. An empty account_id clears it, back to the last used account. Only for the caller themselves; any other account is not found.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_default_account",
    "arguments": {}
  }
}

accounts_set_layoutCopy Anchor Link

Arrange a dashboard. Save how a page's boxes are arranged: widgets in order, each {widget, span 0-12, hidden}. scope person is the caller's own; account is the team's default (owner or admin). Pass base_version from accounts_get_layout (0 when there was none); a newer save is a conflict, read again and save on that. Widget ids are the page's own; unknown ones are skipped by the page.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_layout",
    "arguments": {}
  }
}

accounts_set_notification_soundsCopy Anchor Link

Set my notification sounds. Save the signed-in person's notification sounds: every field, with the revision read (0 when never saved); a stale revision is refused, read again. Specs are checked like the editor's: at most 20 own tones, 32 notes each, under 30 seconds; critical is never silent. Only for the caller themselves; a key is refused.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_notification_sounds",
    "arguments": {}
  }
}

accounts_set_promptCopy Anchor Link

Answer a one-time prompt. Record the signed-in person's choice on a one-time prompt: later (ask again in 7 days; the third later closes it), never (don't remind me again) or done. never and done are final.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_prompt",
    "arguments": {}
  }
}

accounts_set_widget_brandingCopy Anchor Link

Set Ask Io widget branding. Change the account's Ask Io widget branding: name (40), tagline (160), avatar_url and logo_url (https), colors.accent, colors.accent_foreground and colors.surface (#rrggbb); the title stays AI Agent. A field left out stays; an empty string clears it back to the default. Pass base_revision, the revision accounts_get_widget_branding answered; a newer save is ABORTED, read again and save on that. Only the account's owner or an admin, signed in. Custom values need the Team plan or above: below it the answer is PERMISSION_DENIED with reason PLAN_REQUIRED naming required_plan.

Scopes: mcp:write · changes something · safe to repeat

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_set_widget_branding",
    "arguments": {}
  }
}