XgenPlusXgenPlusHelp Center

MCP admin tools for domain admins

Domain admins get 12 extra read-only MCP tools to look up account facts about users in their own domain, such as storage, limits, aliases and mailing lists. These tools change nothing and cannot read anyone's mail. There is no tick box. Every agent on a domain admin mailbox gets them, whatever its permissions.

For: Domain adminWebAI

When to use it

Priya looks after acme.in. Priya's assistant answers "Who in my domain expires in the next 30 days, and who is nearly out of mailbox space?" without Priya opening each user in the admin console.

Who can use them

  • Domain admins only. Create an agent password in webmail and make the token, the same way as any user. Login must be ticked. There is no separate tick box for admin tools: the account type gives access.
  • Works with any agent permissions. Every agent password on a domain admin mailbox gets the admin tools, including one with Send & Save ticked. If that agent reads a crafted email, it could be steered towards mailing out directory details. Risky sends are still held for review, but mail to colleagues or already-known people is not held. For extra care, leave Send & Save off on the agent you use for admin lookups.
  • The agent keeps the normal mailbox tools its permissions allow.

What they can and cannot do

  • Look up, never change. No admin tool can edit, add, reset or delete anything.
  • Your own domain only. A user in another domain is reported as not found.
  • Other admins. Other domain admins and support admins appear in admin_search_users with name, email, type, status, last login and expiry, but their details cannot be opened. Group admins can be opened. You can open your own.
  • No mail access. These tools show account facts. They cannot read anyone's mail.
  • Limits. The same limits as other tools apply. admin_search_users, admin_list_mailing_lists and admin_get_mailing_list also use the search limit.

Tools

Tool What it shows
admin_search_users Find users by name or email, or list them all, 50 per page: type, active, last login, expiry. Owner, server and billing accounts are not listed.
admin_get_user User id, email, name, display name, type, status, phone, company, created, last login and its IP address, multiple sessions
admin_get_user_storage Allowed and used mailbox space, percent used, unlimited or not. Used space can lag behind.
admin_get_user_limits Limits on folders, incoming and outgoing mail per day, data per day, contacts, rules, attachment size and recipients
admin_get_user_expiry When the user's account and the domain expire
admin_list_aliases The user's email aliases and the date each was added
admin_get_user_access Which services are on, including POP and IMAP, with the POP and IMAP since dates
admin_get_user_security 2-step sign-in, alternate email, phone, allowed home and office IP addresses and countries
admin_list_mailing_lists Mailing lists with subscriber and moderator counts, 50 per page
admin_get_mailing_list One list's moderators, up to 200, and subscribers with their type, 50 per page
admin_get_domain_summary Users, inactive users, accounts expiring in 30 days, storage, licensed users and space, domain expiry, mailing lists
admin_list_agent_users Who has an agent password: agent name, active or not, created and expiry. Ordinary users, Xgen Air accounts, group admins and you, up to 200. Other admins' agents are not shown.

What you can ask

  • "Is Priya's IMAP on?"
  • "List the subscribers of sales@."
  • "Which of my users have connected an AI agent?"
  • "Give me a summary of my domain."

Good to know

  • Privacy. What these tools return, including colleagues' names, phone numbers, alternate emails and last sign-in addresses, goes to the assistant and its AI provider. Choose a provider with that in mind. See MCP privacy and security.

Common questions

Can a domain admin's assistant read my mail?

No. Admin tools show account facts such as storage, limits and aliases, never mail.

Why can my agent not use admin tools?

Admin tools need a domain admin mailbox. On any other mailbox they return SCOPE_REQUIRED naming domain_admin, and there is no permission to turn on. Use an agent password from a domain admin mailbox.

Can admin tools change a user or reset a password?

No. They only look things up. No admin tool can edit, add, reset or delete anything.

Was this page helpful? Updated 2026-11-02