AIvikings MCP tools reference

Confirm the connection is authenticated and see which customer the agent is acting as.

No input parameters.

The authenticated flag plus the customer id, name, and email. api_key_id is null on an OAuth/bearer session.

{
  "tool": "get_current_user",
  "arguments": {}
}

Read the stored profile for the account the token belongs to. A supplied customer id must match the token.

The customer record linked to the bearer token.

{
  "tool": "get_customer",
  "arguments": {
    "customer_id": "cus_XXXXXXXXXXXX"
  }
}

Provision a downstream customer record. Does not return credentials.

The created customer record.

{
  "tool": "create_customer",
  "arguments": {
    "email": "hello@customer.icu",
    "preferred_currency": "USD"
  }
}

Check funds before registering or renewing. Shows USD and EUR wallets.

Balance in the requested currency plus a per-wallet breakdown. When automatic conversion is on, a zero balance in one currency does not block a purchase if the other wallet has enough credit.

{
  "tool": "get_prepaid_balance",
  "arguments": {
    "currency": "USD"
  }
}

One-time plumbing to prevent duplicate registrar client records. Rarely needed by hand.

The linked or newly created provider client reference.

{
  "tool": "reconcile_provider_client",
  "arguments": {}
}

Look up a single exact name and get its price in one call.

A one-item domains array with availability, long_domain flag, domain_type, prices, premium flag, environment, and the provider code and description.

{
  "tool": "check_single_domain_availability",
  "arguments": {
    "domain": "exampledomain.icu",
    "currency": "USD"
  }
}

Batch-check a list of candidate names. is_premium flags premium pricing; domain_type only reflects name length.

A domains array, one entry per input name, in the same shape as the single check.

{
  "tool": "check_domain_availability",
  "arguments": {
    "domains": [
      "myproject.icu",
      "myproject.sbs",
      "myproject.cfd"
    ],
    "currency": "USD"
  }
}

Show registration, renewal, and transfer prices, and the per-year registration schedule, before committing.

Customer-facing registration, renewal, and transfer prices, a registration_prices array by year, min and max registration years, and is_premium. Never exposes upstream cost prices.

{
  "tool": "get_domain_pricing",
  "arguments": {
    "domain": "exampledomain.icu"
  }
}

Buy a name once you have confirmed availability and a registration-ready contact. Uses account default nameservers when none are given.

The created domain record, including status and expiry once provisioned.

{
  "tool": "register_domain",
  "arguments": {
    "domain": "myproject.icu",
    "period_years": 1,
    "contact_handle": "contact-2"
  }
}

Extend a domain you already own before it expires.

The updated domain record with the new expiry.

{
  "tool": "renew_domain",
  "arguments": {
    "domain": "myproject.icu",
    "period_years": 1
  }
}

Inspect a single domain: status, expiry, nameservers, registrant verification, and lock state.

Status, expiry, nameservers, long_domain, period, contact handle, registrant verification status and date, provider lock flag, and provider code and description.

{
  "tool": "get_domain_status",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Enumerate everything on the account with status, nameservers, contact handle, and dates.

No input parameters.

A domains array. Each entry has id, domain, status, long_domain, period_years, nameservers, contact_handle, customer_id, expires_at, created_at, and updated_at.

{
  "tool": "list_domains",
  "arguments": {}
}

Audit for drift between the local datastore and the configured registrar provider.

No input parameters.

A reconciliation summary of matches and differences.

{
  "tool": "reconcile_domains",
  "arguments": {}
}

Bring an existing domain from another registrar, using its auth code.

The transfer request record and its status.

{
  "tool": "domain_transfer",
  "arguments": {
    "domain": "example.icu",
    "auth_code": "AUTH-CODE-HERE",
    "period_years": 1
  }
}

Retrieve the code needed to transfer a domain out to another registrar. Fetched on demand.

The current EPP auth code for the domain.

{
  "tool": "get_transfer_auth_code",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Rotate the transfer code, for example if the previous one may be compromised.

The new EPP auth code. The previous code stops working.

{
  "tool": "regenerate_transfer_auth_code",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Protect a domain from being transferred away.

Confirmation that the transfer lock is on.

{
  "tool": "lock_domain",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Prepare a domain for transfer out by removing its lock.

Confirmation that the transfer lock is off.

{
  "tool": "unlock_domain",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Delegate a domain to a different DNS provider or back to AIvikings.

The updated nameserver set for the domain.

{
  "tool": "update_nameservers",
  "arguments": {
    "domain": "kaffe.icu",
    "nameservers": [
      "ns1.aivikings.net",
      "ns2.aivikings.net"
    ]
  }
}

Read the current zone before editing. Use the returned id to update or delete a record.

A records array. Each record has recordName, recordType, recordContent, recordTTL, recordPriority, and dnszoneRecordID (the id to pass to update or delete). Note the provider spells one field recordWeieght.

{
  "tool": "list_dns_records",
  "arguments": {
    "domain": "kaffe.icu"
  }
}

Quick path to point a name at an IP. Use @ or omit record_name for the root; pass a relative name like www or staging.api for a subdomain.

The A record that was set.

{
  "tool": "configure_dns_record",
  "arguments": {
    "domain": "kaffe.icu",
    "record_name": "@",
    "record_value": "87.62.127.19"
  }
}

Create a new record. Relative names expand under the domain, including nested names; use @ for the apex. SRV needs port and weight.

The created record, including its dnszoneRecordID.

{
  "tool": "add_dns_record",
  "arguments": {
    "domain": "kaffe.icu",
    "record_name": "@",
    "record_type": "MX",
    "record_value": "mail.kaffe.icu",
    "record_priority": 10
  }
}

Change a record in place. Call list_dns_records first to get its dnszoneRecordID. All fields describe the desired replacement.

The updated record.

{
  "tool": "update_dns_record",
  "arguments": {
    "dns_zone_record_id": "1113100947",
    "domain": "kaffe.icu",
    "record_name": "@",
    "record_type": "A",
    "record_value": "203.0.113.10"
  }
}

Remove a record. Call list_dns_records first and pass the exact dnszoneRecordID. This cannot be undone.

Confirmation of deletion.

{
  "tool": "delete_dns_record",
  "arguments": {
    "dns_zone_record_id": "1113104636",
    "domain": "kaffe.icu"
  }
}

Make a contact once and reuse its handle across many domains. Handle is generated if omitted.

The created contact, including its handle for use in register_domain.

{
  "tool": "create_contact",
  "arguments": {
    "name": "Alex Customer",
    "email": "hello@customer.icu",
    "address": "Agent Street 1",
    "city": "Copenhagen",
    "state": "Copenhagen",
    "postal_code": "1000",
    "country": "Denmark",
    "phone_country_code": "45",
    "phone_number": "12345678"
  }
}

See existing contacts, their handles, default roles, and how many domains use each.

No input parameters.

Contact records with handle, name, email, address fields, the default_* role flags, used_by_domain_count, and timestamps.

{
  "tool": "list_contacts",
  "arguments": {}
}

Read a single contact's full details.

The full contact record.

{
  "tool": "get_contact",
  "arguments": {
    "contact_handle": "contact-2"
  }
}

Always call before register_domain. Shows which contacts are complete, what fields are missing, and their default roles.

No input parameters.

Registration contact handles, each with a registration-ready flag, any missing required fields, and default role assignments.

{
  "tool": "list_domain_registration_contacts",
  "arguments": {}
}

Make a contact the default for registrant, admin, technical, and/or billing. Replaces the prior default for each role set.

The updated default-role assignments.

{
  "tool": "assign_domain_registration_contact_roles",
  "arguments": {
    "contact_handle": "contact-2",
    "assign_registrant": true,
    "assign_admin": true
  }
}

Clear a contact's default roles. Does not delete the contact. Removing a role without assigning it elsewhere can make registration validation fail unless register_domain is given an explicit contact.

The updated default-role assignments.

{
  "tool": "remove_domain_registration_contact_roles",
  "arguments": {
    "contact_handle": "contact-2",
    "remove_billing": true
  }
}

Change a domain's registrant. Name, organization, or email changes require acknowledge_transfer_lock=true and can impose a 60-day transfer lock while verification completes.

The updated registrant details. A provider-accepted change is reported as verification pending until the registrant completes verification.

{
  "tool": "update_registrant_contact",
  "arguments": {
    "domain": "kaffe.icu",
    "contact_handle": "contact-2"
  }
}