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
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
org_id | string | |
page_size | integer | At most 200 (larger is coerced down); 0 means 50. |
page_token | string | From 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
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; an alias of org_id. Leave both out for the caller's own account. |
domain | string | |
org_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "accounts_get_domain",
"arguments": {
"domain": "example.com"
}
}
}