Tool reference

21 tools, scoped to the authenticated user. Badges: read never mutates, write creates or updates, delete permanently removes data.

Domains

The core of the portfolio. Every domain belongs to a project and a registrar account.

list_domains read

List domains in your portfolio, with optional filters and pagination. Returns lean rows by default; the response includes total and hasMore.

projectIduuidoptional· filter to one project

registrarAccountIduuidoptional· filter to one registrar account

status"Active" | "Expired" | "Transferred" | "Unknown"optional

searchstringoptional· case-insensitive substring match on the domain name

expiringWithinDaysintegeroptional· expiring within N days; excludes already-expired unless includeExpired

includeExpiredbooleanoptionaldefault false· include past-due domains when filtering by expiringWithinDays

fields"summary" | "full"optionaldefault "summary"· full adds notes, ids, dateLastChecked, and timestamps

limitintegeroptionaldefault 25· max 500

offsetintegeroptionaldefault 0· skip rows for pagination

get_domain read

Fetch one domain by id or by exact domain name.

iduuidoptional· provide id or domainName

domainNamestringoptional

add_domain write

Add a domain to a project under a registrar account.

domainNamestringrequired

projectIduuidrequired

registrarAccountIduuidrequired

status"Active" | "Expired" | "Transferred" | "Unknown"optionaldefault "Active"

autoRenewbooleanoptionaldefault false

expiryDatestringoptional· YYYY-MM-DD

notesstringoptional· max 2000 chars

update_domain write

Update fields on a domain. Only provided fields change.

iduuidrequired

domainNamestringoptional

status"Active" | "Expired" | "Transferred" | "Unknown"optional

autoRenewbooleanoptional

expiryDatestring | nulloptional· YYYY-MM-DD; null clears it

notesstringoptional· max 2000 chars; empty string clears it

projectIduuidoptional· move to another project

registrarAccountIduuidoptional

delete_domain delete

Permanently delete a domain. Irreversible.

iduuidrequired

bulk_add_domains write

Add up to 200 domains in one call. Returns added rows and per-row errors so a single bad entry never fails the batch.

domainsobject[]required· 1 to 200 entries, each shaped like add_domain

domains_expiring_soon read

Domains expiring within N days, soonest first. Excludes already-expired domains unless includeExpired is set.

withinDaysintegeroptionaldefault 30· max 3650

includeExpiredbooleanoptionaldefault false· also include overdue (past-due) domains

limitintegeroptionaldefault 100· max 500

Projects

Organizational grouping for domains. Membership controls access.

list_projects read

List projects you belong to, with your role and a domain count.

No parameters.

add_project write

Create a project. You become its owner.

namestringrequired· max 100 chars

descriptionstringoptional· max 500 chars

update_project write

Rename or re-describe a project. Requires edit access.

iduuidrequired

namestringoptional

descriptionstringoptional

delete_project delete

Delete a project and ALL of its domains. Owner only. Irreversible. Requires confirm: true.

iduuidrequired

confirmbooleanoptionaldefault false· must be true to delete; otherwise returns the domain count that would be removed

Registrars

The registrar platforms you use (Namecheap, Porkbun, Cloudflare, …).

list_registrars read

List your registrar platforms with account counts.

No parameters.

add_registrar write

Add a registrar platform.

namestringrequired

urlstringoptional· e.g. namecheap.com

update_registrar write

Update a registrar's name or URL.

iduuidrequired

namestringoptional

urlstringoptional

delete_registrar delete

Delete a registrar. Cascades to its accounts and their domains. Irreversible. Requires confirm: true.

iduuidrequired

confirmbooleanoptionaldefault false· must be true to delete; otherwise returns the account + domain counts that would be removed

Registrar accounts

Individual logins at a registrar. One account can hold domains across many projects. API credentials cannot be set through MCP.

list_registrar_accounts read

List your registrar accounts, optionally filtered.

registrarIduuidoptional· filter by registrar

add_registrar_account write

Add an account under one of your registrars.

registrarIduuidrequired

displayNamestringrequired

accountUsernamestringrequired

contactEmailstringoptional

domainListUrlstringoptional

update_registrar_account write

Update fields on a registrar account.

iduuidrequired

displayNamestringoptional

accountUsernamestringoptional

contactEmailstringoptional

domainListUrlstringoptional

isActivebooleanoptional

delete_registrar_account delete

Delete a registrar account. Cascades to its domains. Irreversible. Requires confirm: true.

iduuidrequired

confirmbooleanoptionaldefault false· must be true to delete; otherwise returns the domain count that would be removed

Sync (read-only)

Inspect the history of your monthly registrar sync rounds.

recent_sync_logs read

Most recent sync logs across your registrar accounts.

limitintegeroptionaldefault 20· max 100

registrarAccountIduuidoptional

latest_sync_session read

Your most recent monthly sync session and its per-account checklist.

No parameters.

← Connect a client Errors & limits