Sign in
Docs
0%

Accounts and access

Domains tools for assistants (MCP)

The 2 tools an assistant can call for Domains over MCP: what each one does, the scopes it needs, its arguments and an example call.

Domains the account has proved it controls. Add a domain, publish the one DNS TXT record it gives you, check that public resolvers see it, then confirm it. A verified domain counts for one account at a time; removing it stops single sign-on, agents and checks bound to it at once. Use it before you rely on a domain anywhere in the account. An assistant calls these tools over MCP; the same operations over HTTP are in the Domains API. Tools for assistants lists every product, and MCP shows how to connect an assistant.

accounts_list_domains

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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
org_idstring
page_sizeintegerAt most 200 (larger is coerced down); 0 means 50.
page_tokenstringFrom the previous page's next_page_token; "" for the first. Opaque; a token used for another account is INVALID_ARGUMENT.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_list_domains",
    "arguments": {
      "page_size": 20
    }
  }
}

accounts_get_domain

Get domain. Calls iohr.accounts.v1.AccountsService/GetDomain.

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

ArgumentTypeWhat it is
account_idstringThe account's id; an alias of org_id. Leave both out for the caller's own account.
domainstring
org_idstring
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts_get_domain",
    "arguments": {
      "domain": "example.com"
    }
  }
}