Skip to main content
Glama

Server Details

Register and manage domains, DNS, VPS, email, and self-hosted AI agents with 113 tools. By OSIR.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
Osir-Inc/mcp-a2a
GitHub Stars
0
Server Listing
Domain Name OSIR MCP
ChatGPT
–
Claude
–

TDQS

A3.6/5.0

Scored across 113 tools

Disambiguation3/5

Most resource+action pairs are distinct (DNS records, contacts, mailboxes, VPS, apps), and descriptions frequently add 'prefer X over Y' guidance. However there is a large cluster of near-duplicate suggestion/catalog tools — generateDomainSuggestions, suggestAlternatives, addPrefixToDomain, addSuffixToDomain, spinDomainWords, bulkDomainSuggestions, checkKeywordAvailability vs checkKeywordAvailabilitySummary — plus overlapping account/activity tools and transferDomain vs initiateTransfer. An agent must read descriptions carefully to pick the right one, which is a real misselection risk at this scale.

Naming Consistency4/5

Names are uniformly camelCase and overwhelmingly verb-first (listX, getX, createX, updateX, deleteX, orderVps, registerDomain). Minor deviations: the osirApp*/osirAgent* families put the verb after a namespace prefix, and a few names are noun-ish (spinDomainWords, suggestAlternatives). Still highly predictable and readable.

Tool Count2/5

113 tools is far beyond a well-scoped surface, even for a server spanning domains, DNS, contacts, VPS, mail, billing, app hosting, AI agents and site publishing. The redundancy (seven or so domain-suggestion tools, three or four catalog/pricing tools, two log tools that both report 'not available yet') shows sprawl rather than each tool earning its place.

Completeness4/5

Coverage is broad: domain lifecycle (register/renew/transfer/lock/privacy/nameservers/audit), DNS records and zones, contacts, mail domain/mailbox management, VPS ordering/rebuild/keys, billing and invoices, app and agent deployment, plus auth/onboarding. Minor gaps exist — no domain deletion/cancellation, no DNSSEC, no VPS power/resize operations, no mail aliases/forwarding — but these are workaround-able and not central to the stated purpose.

Available Tools

113 tools
addPrefixToDomainA
Read-onlyIdempotent
Inspect

addPrefixToDomain: Generate domain suggestions by adding prefixes to a base name.

Inputs: name (required), lang, tlds, maxResults, +1 more.

addSshKeyA
Idempotent
Inspect

addSshKey: Store an SSH public key on your account so it can be injected into VPS installs. Idempotent: storing a key you already have returns the existing one instead of creating a duplicate, so it is safe to call before every order. Returns the key id to pass to orderVps or buildVpsInstance. Requires authentication.

Inputs: name (required), publicKey (required), sessionKey.

addSuffixToDomainB
Read-onlyIdempotent
Inspect

addSuffixToDomain: Generate domain suggestions by adding suffixes to a base name.

Inputs: name (required), lang, tlds, maxResults, +1 more.

buildVpsInstanceA
Destructive
Inspect

buildVpsInstance: Stage an operating system install (or reinstall) on a VPS instance. DESTRUCTIVE: ERASES ALL DATA on the server, including any deployed application, and cannot be undone. The install is asynchronous; afterwards poll getVpsInstanceDetails until buildState is COMPLETE. If an Osir app was deployed onto this instance, a rebuild erases it; re-attach it afterwards with osirAppDeployToVps. Never rebuild a box just to install an app runtime by hand. Requires authentication. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: instanceId (required), operatingSystemId (required), swap, hostname, +2 more.

bulkDomainSuggestionsA
Read-onlyIdempotent
Inspect

bulkDomainSuggestions: Generate domain suggestions for 1-10 keywords across 1-6 TLDs (hard cap), grouped by originating keyword. Typical flow: call listCategorizedTlds first to pick 3-6 TLDs, then this tool. Per-suggestion availability may be "available", "taken", or "unknown"; confirm "unknown" or premium-TLD names with checkDomainAvailability before recommending.

Inputs: tlds (required), keywords (required), lang, maxResults.

cancelTransferA
DestructiveIdempotent
Inspect

cancelTransfer: Stage cancellation of a pending domain transfer. DESTRUCTIVE and irreversible once executed. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: domain (required), sessionKey.

changeVpsPaymentTermAInspect

changeVpsPaymentTerm: Stage a change of the payment term (billing cycle) for a VPS instance. Affects what you are billed. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: instanceId (required), paymentTerm (required), sessionKey.

checkDeviceLoginStatusAInspect

checkDeviceLoginStatus: Poll for device login completion. Call this after loginWithDevice() once you have opened the verification URL and signed in. Required: deviceCode (the device_code returned by loginWithDevice). On success returns a sessionKey; pass it as the sessionKey argument on every subsequent authenticated tool call.

Inputs: deviceCode (required). Returns: status, message, success, expiresIn, +2 more

checkDomainAvailabilityA
Read-onlyIdempotent
Inspect

checkDomainAvailability: Check if a domain name is available for registration, with price. No authentication required; anonymous callers get list pricing, authenticated callers get their account pricing. Required: domain (e.g., 'example.com')

Inputs: domain (required), sessionKey. Returns: price, domain, message, currency, +2 more

checkHostAvailabilityA
Read-onlyIdempotent
Inspect

checkHostAvailability: Check if a host/glue record name is available for creation. Requires authentication. Returns whether the hostname is free; call before createHost.

Inputs: hostname (required), sessionKey.

checkKeywordAvailabilityA
Read-onlyIdempotent
Inspect

checkKeywordAvailability: Check keyword availability across all supported TLDs and registries with detailed per-domain results. Use checkKeywordAvailabilitySummary instead when you only need counts; it is faster.

Inputs: keyword (required), tlds, registries.

checkKeywordAvailabilitySummaryA
Read-onlyIdempotent
Inspect

checkKeywordAvailabilitySummary: Check keyword availability across TLDs and registries. Summary statistics only (no per-domain results), faster than checkKeywordAvailability.

Inputs: keyword (required), tlds, registries.

countMyVpsInstancesA
Read-onlyIdempotent
Inspect

countMyVpsInstances: Get the total count of VPS instances owned by the authenticated user. Requires authentication.

Inputs: sessionKey.

createAccountA
Idempotent
Inspect

createAccount: Create a new OSIR customer account; step 1 of onboarding, no authentication required. The contact must be the PRINCIPAL's real ICANN registrant contact (the human or business the account is for), never the AI agent itself. Sends a verification email; complete via verifyAccount with the emailed code. While PENDING_VERIFICATION the account can search, quote and fund; billable actions need ACTIVE. Calling again for a PENDING account re-sends the verification email.

Inputs: email (required), contact (required), accountType (required), termsVersion (required), +5 more. Returns: status, accountId, contactId, nextSteps, +1 more

createContactAInspect

createContact: Create a new contact for use with domain registrations. Requires authentication. Returns the created contact including its id for assignment to domains (registerDomain registrantId). For .al domains (AKEP): registryAttributes is required, postalCode is required, state is the region not the country, no ';' in street, prefer plain ASCII. For a company use the director or contact person as first/last name, the company as organization, entityType 'Person Juridik Privat', its NIPT/VAT, and the director's ID or passport.

Inputs: city (required), email (required), phone (required), country (required), +9 more.

createDnsRecordAInspect

createDnsRecord: Create a new DNS record for a domain. Requires authentication. For newly registered domains the zone is initialized automatically if missing. Returns the created record including its id for later updates or deletion.

Inputs: name (required), type (required), domain (required), content (required), +3 more.

createHostAInspect

createHost: Create a new host/glue record, e.g. for custom nameservers like 'ns1.example.com'. Requires authentication. Check the name first with checkHostAvailability. Returns the created host record.

Inputs: hostname (required), ipAddresses (required), sessionKey.

createMailboxAInspect

createMailbox: Stage creation of a paid mailbox on a mail-enabled domain. BILLABLE: deducts from account balance; get a quote with getMailboxQuote and confirm the price with the user first. Requires authentication. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve. The result of the confirmed action contains the generated password EXACTLY ONCE; it can never be retrieved again, so show it to the user immediately (they can change it later with setMailboxPassword). Also share the client settings from the result (IMAP/SMTP/webmail).

Inputs: domain (required), localPart (required), packageId (required), term, +1 more.

createPaymentSessionAInspect

createPaymentSession: Stage a Stripe checkout session to add funds to the account balance. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve. The executed result includes checkoutUrl (hand it to the human to pay) and expiresAt; then poll getPaymentTransactions until the balance credit appears.

Inputs: amount (required), currency, sessionKey.

deleteContactA
DestructiveIdempotent
Inspect

deleteContact: Stage deletion of a contact. DESTRUCTIVE; fails if the contact is assigned to active domains. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: contactId (required), sessionKey.

deleteDnsRecordA
DestructiveIdempotent
Inspect

deleteDnsRecord: Stage deletion of a DNS record. DESTRUCTIVE and irreversible once executed. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: domain (required), recordId (required), sessionKey.

deleteHostA
DestructiveIdempotent
Inspect

deleteHost: Stage deletion of a host/glue record. DESTRUCTIVE and irreversible once executed. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: hostname (required), sessionKey.

deleteMailboxA
DestructiveIdempotent
Inspect

deleteMailbox: Stage deletion of a mailbox. The mailbox stops working immediately and its data is destroyed after a 14-day grace period. Requires authentication. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: mailboxId (required), sessionKey.

deleteSshKeyA
DestructiveIdempotent
Inspect

deleteSshKey: Stage removal of an SSH key from your account. This does not affect servers already built with it, and the key can simply be added again. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: keyId (required), sessionKey.

deleteVpsInstanceA
DestructiveIdempotent
Inspect

deleteVpsInstance: Stage deletion/cancellation of a VPS instance. DESTRUCTIVE and irreversible. Requires authentication. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: instanceId (required), sessionKey.

enableMailDomainA
Idempotent
Inspect

enableMailDomain: Enable email hosting on a domain you own. Free; mailboxes are what cost money. If the call fails with a DNS conflict (an existing SPF or MX record), ask the user for explicit consent, then re-call with spfMergeConfirmed=true and/or takeoverConfirmed=true. Requires authentication.

Inputs: domain (required), dnsMode, sessionKey, spfMergeConfirmed, +1 more.

executeConfirmedActionA
DestructiveIdempotent
Inspect

executeConfirmedAction: Execute a previously staged destructive or financial action after user approval. The action expires after 5 minutes and can only be executed once.

Inputs: actionId (required), sessionKey.

fundBalanceWithSharedPaymentTokenAInspect

fundBalanceWithSharedPaymentToken: Stage adding funds to the balance by charging a Stripe Shared Payment Token the customer granted to OSIR. Use when a purchase (registerDomain, renewDomain, transferDomain, orderVps) failed for insufficient funds: that error tells you the networkId to mint against and both amounts. Mint the token for the GROSS and pass the NET as creditCents. Tokens are single-use. Requires authentication. Returns an actionId; tell the user what the card will be charged, then call executeConfirmedAction with the actionId if they approve. If this fails in any way you cannot fix by minting a fresh token, fall back to createPaymentSession and give the user the checkout URL.

Inputs: creditCents (required), sharedPaymentToken (required), currency, sessionKey, +2 more.

generateDomainSuggestionsA
Read-onlyIdempotent
Inspect

generateDomainSuggestions: Generate domain name suggestions based on keywords. This is the preferred suggestion tool for a single keyword; use it over suggestAlternatives. Returns suggested names with availability.

Inputs: name (required), lang, tlds, maxResults, +1 more.

getAccountBalanceB
Read-onlyIdempotent
Inspect

getAccountBalance: Get the current account balance for the authenticated user. Requires authentication.

Inputs: sessionKey. Returns: balance, message, success, currency

getAccountSummaryA
Read-onlyIdempotent
Inspect

getAccountSummary: Get a comprehensive summary of the user's account: profile, balance, domain count, VPS count, and pending transfers. Requires authentication.

Inputs: sessionKey.

getAuthStatusA
Read-onlyIdempotent
Inspect

getAuthStatus: Check whether the current session is authenticated. Returns authenticated status and token expiry. Optional: sessionKey (from checkDeviceLoginStatus).

Inputs: sessionKey. Returns: username, authenticated, tokenExpiresIn

getContactA
Read-onlyIdempotent
Inspect

getContact: Get detailed information about a specific contact. Requires authentication. Get the contactId from listContacts. Returns name, email, phone, organization, and address.

Inputs: contactId (required), sessionKey.

getContactsForDomainA
Read-onlyIdempotent
Inspect

getContactsForDomain: Get all contacts (registrant, admin, tech, billing) assigned to a domain. Requires authentication. Returns the contact assigned to each role.

Inputs: domain (required), sessionKey.

getDedicatedServerCatalogA
Read-onlyIdempotent
Inspect

getDedicatedServerCatalog: Get all available dedicated server configurations with pricing and specifications. No authentication required.

Inputs: no named parameters.

getDnsRecordA
Read-onlyIdempotent
Inspect

getDnsRecord: Get details of a specific DNS record by id. Requires authentication. Get the recordId from listDnsRecords. Returns the record's name, type, content, TTL, and priority.

Inputs: domain (required), recordId (required), sessionKey.

getDomainAuditTrailA
Read-onlyIdempotent
Inspect

getDomainAuditTrail: Get the audit trail (history of all changes) for a specific domain. Requires authentication.

Inputs: domain (required), sessionKey.

getDomainExtensionsB
Read-onlyIdempotent
Inspect

getDomainExtensions: Get all available domain extensions (TLDs) with pricing information. No authentication required.

Inputs: no named parameters.

getDomainInfoA
Read-onlyIdempotent
Inspect

getDomainInfo: Get registry (EPP) state plus account settings for one domain: status, nameservers, lock state, auto-renew, privacy, creation/expiry dates, premium/expired/redemption info. Dates are null while a registration is still pending at the registry; autoRenew is omitted for transferredOut domains.

Inputs: domain (required), sessionKey.

getDomainPricingA
Read-onlyIdempotent
Inspect

getDomainPricing: Get pricing for domain extensions from the product catalog. Requires authentication.

Inputs: extension, sessionKey. Returns: message, pricing, success

getHostingBundleA
Read-onlyIdempotent
Inspect

getHostingBundle: Get the hosting options and exact prices for a specific domain: recommended VPS packages (cheapest first), email plans, web forwarding, and app/site deployment. No authentication required. Call this ONCE after a successful availability check or registration to make a concise hosting offer; do not repeat the offer in the same conversation. Prices are display prices; the authoritative amount is computed at purchase.

Inputs: domain (required). Returns: domain, options, nextSteps

getHostsForDomainA
Read-onlyIdempotent
Inspect

getHostsForDomain: List all host/glue records associated with a domain. Requires authentication. Returns each host name and its IP addresses.

Inputs: domain (required), sessionKey.

getInvoiceDetailsA
Read-onlyIdempotent
Inspect

getInvoiceDetails: Get detailed information about a specific invoice including line items. Requires authentication.

Inputs: invoiceId (required), sessionKey.

getInvoiceStatisticsA
Read-onlyIdempotent
Inspect

getInvoiceStatistics: Get summary statistics of invoices: total paid, pending, overdue amounts. Requires authentication.

Inputs: sessionKey.

getMailboxQuoteA
Read-onlyIdempotent
Inspect

getMailboxQuote: Get a display-only price quote for a mailbox plan. The backend re-derives the authoritative price at purchase. Requires authentication.

Inputs: packageId (required), term, sessionKey. Returns: term, message, success, currency, +4 more

getMailboxUsageA
Read-onlyIdempotent
Inspect

getMailboxUsage: Get disk usage per mailbox in bytes, for quota display alongside the plan's quotaBytes. Requires authentication.

Inputs: sessionKey.

getMailDnsRecordsA
Read-onlyIdempotent
Inspect

getMailDnsRecords: Get the DNS records a mail domain needs (MX, SPF, DKIM, ...), for customers managing DNS externally. Requires authentication.

Inputs: domain (required), sessionKey.

getMyAuditLogsA
Read-onlyIdempotent
Inspect

getMyAuditLogs: Get recent audit logs for the authenticated user across all services. Requires authentication.

Inputs: page, size, sessionKey.

getMyProfileA
Read-onlyIdempotent
Inspect

getMyProfile: Get the authenticated user's profile and account information including name, email, organization, balance, and domain/VPS counts. Requires authentication.

Inputs: sessionKey.

getPaymentTransactionsA
Read-onlyIdempotent
Inspect

getPaymentTransactions: Get payment transaction history for the authenticated user. Requires authentication.

Inputs: page, size, sessionKey.

getProductCatalogA
Read-onlyIdempotent
Inspect

getProductCatalog: Get the complete product catalog including domain extensions, VPS packages, and dedicated servers. No authentication required.

Inputs: no named parameters.

getRecentActivityB
Read-onlyIdempotent
Inspect

getRecentActivity: Get the most recent activity across all domains and services for the user. Requires authentication.

Inputs: sessionKey.

getTransferQuoteA
Read-onlyIdempotent
Inspect

getTransferQuote: Get a transfer price quote for a domain. Requires authentication. Returns transfer price, currency, extension years, and new expiration date. Call before initiateTransfer to show the user the cost.

Inputs: domain (required), sessionKey. Returns: domain, message, success, currency, +3 more

getTransferStatusA
Read-onlyIdempotent
Inspect

getTransferStatus: Check the current status of a domain transfer. Requires authentication. Returns status, request date, current registrar, and expected completion.

Inputs: domain (required), sessionKey.

getVpsInstanceDetailsB
Read-onlyIdempotent
Inspect

getVpsInstanceDetails: Get detailed information about a specific VPS instance including resource usage. Requires authentication.

Inputs: instanceId (required), sessionKey.

getVpsPackageDetailsA
Read-onlyIdempotent
Inspect

getVpsPackageDetails: Get detailed information about a specific VPS package including all pricing tiers. Requires authentication. For anonymous browsing use listVpsPackages, which already includes per-term pricing.

Inputs: packageId (required), sessionKey.

initializeDnsZoneA
Idempotent
Inspect

initializeDnsZone: Initialize (create) the DNS zone for a domain. NOT needed after registerDomain, which initializes the zone automatically. Use only for pre-existing domains without a zone (e.g. after a transfer, or if registration opted out with initializeDnsZone:false). Safe on existing zones, it will not overwrite records. Requires authentication.

Inputs: domain (required), sessionKey.

initiateTransferAInspect

initiateTransfer: Starts a transfer for a domain already prepared at the losing registrar (unlocked, auth code in hand). transferDomain (domain tools) stages transfer + registrant assignment in one step; use that when the user gives you contact details. Deducts from account balance. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: domain (required), authCode (required), sessionKey.

listCategorizedTldsA
Read-onlyIdempotent
Inspect

listCategorizedTlds: List TLDs from the OSIR catalog that have category and audience metadata, with registration and renewal prices as decimal strings (e.g. '10.39'). Use it to pick 3-6 relevant TLDs before calling bulkDomainSuggestions. Filters: price cap, exclude ccTLDs/restricted/premium, registry. Returns unranked candidates with categories, audience, prices, and flags. No auth required.

Inputs: registry, excludeCcTLDs, excludePremium, maxRegisterPrice, +1 more.

listContactsA
Read-onlyIdempotent
Inspect

listContacts: List all contacts for the authenticated user, optionally filtered by a search term. Requires authentication. Returns each contact with its id for use in getContact, updateContact, deleteContact, or domain registration.

Inputs: search, sessionKey.

listDnsRecordsA
Read-onlyIdempotent
Inspect

listDnsRecords: List all DNS records for a domain. Requires authentication. Returns each record with its id, name, type, content, TTL, and priority; use the record id with getDnsRecord, updateDnsRecord, or deleteDnsRecord.

Inputs: domain (required), sessionKey.

listInvoicesA
Read-onlyIdempotent
Inspect

listInvoices: List invoices for the authenticated user with optional status filtering and pagination. Requires authentication.

Inputs: page, size, status, sessionKey.

listMailboxesA
Read-onlyIdempotent
Inspect

listMailboxes: List your mailboxes with plan, payment term, status, and next renewal date. Requires authentication.

Inputs: sessionKey.

listMailDomainsA
Read-onlyIdempotent
Inspect

listMailDomains: List your domains that are enabled for email hosting, with status (PENDING_DNS or ACTIVE) and DNS mode. Requires authentication.

Inputs: sessionKey.

listMailPlansA
Read-onlyIdempotent
Inspect

listMailPlans: List available email mailbox plans with quotas and prices (monthly and annual, in cents). Requires authentication. Always quote prices from here, never from memory.

Inputs: sessionKey.

listMySshKeysA
Read-onlyIdempotent
Inspect

listMySshKeys: List the SSH keys stored on your account, with their ids and SHA256 fingerprints. Use this to check whether a key is already stored and to get the ids to pass to orderVps or buildVpsInstance. Requires authentication.

Inputs: sessionKey.

listMyVpsInstancesA
Read-onlyIdempotent
Inspect

listMyVpsInstances: List all VPS instances owned by the authenticated user. An instanceId from this list is what osirAppDeployToVps takes to put an app on a server the user already owns, at no cost. Requires authentication.

Inputs: sessionKey.

listPendingTransfersA
Read-onlyIdempotent
Inspect

listPendingTransfers: List all pending incoming (gaining) domain transfers. Requires authentication. Returns each transfer with its status, request date, current registrar, and expected completion.

Inputs: sessionKey.

listUserDomainsA
Read-onlyIdempotent
Inspect

listUserDomains: List all domains owned by the authenticated user. No parameters required. Must be authenticated first.

Inputs: sessionKey.

listVpsLocationsA
Read-onlyIdempotent
Inspect

listVpsLocations: List available VPS hosting locations (cities/countries) with available packages. No authentication required.

Inputs: no named parameters.

listVpsOsTemplatesA
Read-onlyIdempotent
Inspect

listVpsOsTemplates: List operating system templates available to install. Requires authentication. Pass EXACTLY ONE of packageId (to pick an operatingSystemId for orderVps, so the server arrives with an OS on it) or instanceId (to pick a template for reinstalling via buildVpsInstance). The two are not interchangeable: the available set depends on the package. Template ids change over time, so always resolve an id here rather than reusing a remembered or hardcoded one.

Inputs: packageId, includeEol, instanceId, sessionKey.

listVpsPackagesA
Read-onlyIdempotent
Inspect

listVpsPackages: List available VPS hosting packages with pricing, specs, and locations. No authentication required.

Inputs: no named parameters.

lockDomainA
Idempotent
Inspect

lockDomain: Enable registrar lock on a domain to prevent unauthorized transfers.

Inputs: domain (required), sessionKey.

loginToVpsPanelAInspect

loginToVpsPanel: Generate a one-time login URL to the VPS control panel (VirtFusion) for managing the server. Requires authentication.

Inputs: instanceId (required), sessionKey.

loginWithDeviceAInspect

loginWithDevice: Start a device authorization login (RFC 8628). Returns a verificationUri and userCode. Open the URI in your browser, enter the code, and sign in with your OSIR credentials. Then call checkDeviceLoginStatus with the returned deviceCode to complete login. No parameters required.

Inputs: no named parameters.

logoutA
Idempotent
Inspect

logout: Log out: revokes the session's tokens at the identity provider immediately. Optional: sessionKey (from checkDeviceLoginStatus); pass it to end that conversation session.

Inputs: sessionKey.

orderVpsAInspect

orderVps: Stage an order for a new VPS instance; deducts from account balance. If this server is being ordered to host an Osir app, do NOT configure it by hand afterwards: deploy the app with osirAppDeploy, then put it on the box with osirAppDeployToVps. Requires authentication. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: hostname (required), packageId (required), paymentTerm (required), sshKeyIds, +2 more.

osirAgentConfigureA
Idempotent
Inspect

osirAgentConfigure: Connect the user's AI agent (e.g. Hermes) to a model provider - 'connect my Hermes to DeepSeek'. Providers: deepseek, openai, openrouter, anthropic. The API key is stored as an encrypted secret, never written into a file or shown again, and the agent restarts on the user's VPS with it. Never paste the key anywhere else. Requires authentication.

Inputs: apiKey (required), agentId (required), provider (required), sessionKey.

osirAgentDeleteA
Destructive
Inspect

osirAgentDelete: Stage removal of the user's AI agent (e.g. Hermes). DESTRUCTIVE: stops and removes the agent from the user's VPS. Its data folder (conversations, memories) stays on the VPS, and the VPS itself is NOT cancelled (that is deleteVpsInstance). Returns an actionId; present the summary and call executeConfirmedAction only if the user approves. Requires authentication.

Inputs: agentId (required), sessionKey.

osirAgentDeployAInspect

osirAgentDeploy: Install a ready-made AI agent - Hermes (Hermes Agent by Nous Research, a self-hosted personal AI agent with a web dashboard) - on the user's OWN VPS, behind HTTPS with a password-protected dashboard. Use this for 'run/install Hermes on my server' INSTEAD of osirAppDeploy, a hand-written Dockerfile, SSH or an install script: the platform installs the vetted agent itself. Needs a VPS with at least 4 GB RAM. TWO WAYS IN, like osirAppDeployToVps: (1) the user already owns a VPS: pass instanceId (from listMyVpsInstances) - spends nothing, no confirmation; (2) no server yet: pass packageId (from listVpsPackages, 4 GB+ RAM) - stages a VPS order (COSTS MONEY): returns an actionId; present the price/summary and call executeConfirmedAction only if the user approves. The result carries the username and the PASSWORD: show the password to the user once, in that reply - it is never shown again (osirAgentResetPassword makes a new one). Then poll osirAgentStatus until installed - it gives the dashboard URL (without a domain, Osir assigns the address; never build it) - and connect a model provider with osirAgentConfigure. Calling this again resumes an install and never buys a second VPS. If the platform says the agent is not available yet, tell the user plainly. Requires authentication.

Inputs: agent (required), domain, username, packageId, +2 more.

osirAgentListA
Read-onlyIdempotent
Inspect

osirAgentList: List the AI agents (e.g. Hermes) the user has installed on their own VPS, with their ids and dashboard URLs. Requires authentication.

Inputs: sessionKey.

osirAgentLogsA
Read-onlyIdempotent
Inspect

osirAgentLogs: Logs of the user's AI agent (e.g. Hermes). Not available yet - the result says so; then use osirAgentStatus. Never invent log contents or ask the user for SSH access. Requires authentication.

Inputs: agentId (required), sessionKey.

osirAgentResetPasswordAInspect

osirAgentResetPassword: Set a new dashboard password for the user's AI agent (e.g. Hermes) - 'I lost the password'. The old one stops working. The new password is in this result only: show it to the user once, in that reply. This is the ONLY way to change the agent's login. Requires authentication.

Inputs: agentId (required), sessionKey.

osirAgentStatusA
Read-onlyIdempotent
Inspect

osirAgentStatus: Is the user's AI agent (e.g. Hermes) installed and working? Reports install progress, the dashboard URL, and whether the dashboard asks for a login (dashboardProtected - checked live). If an install failed, the message says why and what to do. Requires authentication.

Inputs: agentId (required), sessionKey.

osirAppCreateUploadAInspect

osirAppCreateUpload: ONLY for a client with a shell and a project too large to send inline (over 500 files or 6 MiB). Usually you do NOT need this: call osirAppDeploy with the project's files directly. Returns an uploadTicket, a putUrl, and instructions to zip the project and PUT it there; then call osirAppDeploy with the uploadTicket. Requires authentication.

Inputs: sessionKey.

osirAppDeleteA
DestructiveIdempotent
Inspect

osirAppDelete: Stage deletion of an Osir app. DESTRUCTIVE and irreversible: removes its microVM, image, route, and data. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve. Requires authentication.

Inputs: appId (required), sessionKey.

osirAppDeployAInspect

osirAppDeploy: Deploy an app to Osir (free tier) and get a live HTTPS URL; the app runs isolated in a microVM. Send the project's source as 'files' (each {path, content}) - you never zip, upload or make an HTTP request yourself. Returns immediately with status BUILDING: poll osirAppStatus until READY (typically 1-2 min, up to ~7 for a first build) before telling the user the URL is live; if it ends BUILD_FAILED, fix the source and redeploy - never deploy around a failed build by hand. Deploying an existing app name redeploys it (new version) and applies any secrets set via osirAppSetSecret. A plain static website (HTML/CSS/JS with no framework or build step) is also supported: it is auto-detected and served directly; pass language 'node' for it. If the project has its own Dockerfile at the root, the platform builds exactly that: pass language 'node' for it; the container must listen on port 8080. Shared-tier apps get 256 MB / 0.5 CPU, so a big image-based app belongs on the user's own VPS (osirAppDeployToVps). For a ready-made AI agent (Hermes), use osirAgentDeploy - never this tool and never a hand-written Dockerfile. To put the app on the user's OWN VPS, server or production box instead, deploy it here first and then call osirAppDeployToVps - never SSH into the box or write an install script. Once an app is on the user's own VPS, redeploying HERE under the same name is how you update it: the platform re-ships it to the box and keeps its domain. Requires authentication.

Inputs: name (required), language (required), files, region, +2 more.

osirAppDeployToVpsAInspect

osirAppDeployToVps: Deploy a live Osir app onto the user's own VPS / server / production box, moving it off the shared free tier. Use this INSTEAD of SSH, a provisioning or install script, nginx/systemd/TLS configuration, or any manual server setup - the platform ships the app to the box itself over its own deploy key, so the assistant needs no shell access and no outbound SSH. This is the ONLY supported way to put an app on a user's own server or a custom domain. TWO WAYS IN. (1) The user already owns a VPS: pass instanceId (from listMyVpsInstances) and NO packageId - this ATTACHES the app to that server, SPENDS NOTHING and needs no confirmation. (2) No server yet: pass packageId (from listVpsPackages) and the call stages a VPS order (COSTS MONEY): returns an actionId; present the price/summary to the user and call executeConfirmedAction only if they approve. Before staging any order this tool checks whether the user ALREADY has a box for this app (its C2 binding, then their own VPS list) and attaches that instead - a retry after a failed move never buys a second server. After the move starts the platform ships the app onto the box server-side, which takes about two minutes; watch it with osirAppStatus ('ownedMove'). Calling this tool again while a move is still running just reports its progress, and calling it after one FAILED retries the ship - unless osirAppStatus says the VPS refused the Osir deploy key or its web ports are taken: then retry only after the user has made the changes that message lists. If the result status is BUILDING or BUILD_FAILED, follow its nextStep. After the move the app is served ONLY from the user's server: its earlier osir.app address stops working. Give the user the URL from osirAppStatus, and never tell them the old link still works. Requires authentication.

Inputs: appName (required), domain, packageId, instanceId, +1 more.

osirAppGetSourceA
Read-onlyIdempotent
Inspect

osirAppGetSource: Get a deployed Osir app's current source, to make edits without the user re-attaching the project. With inline=true it returns the files themselves: patch them and call osirAppDeploy with ALL the files under the SAME name; the platform rebuilds and, for owned-tier apps, auto-ships the new version to the user's box. If the result says truncated=true the files are only PART of the app - do NOT redeploy from them. Without inline it returns only a short-lived signed zip URL (getUrl), useful only to a client with a shell. Requires authentication.

Inputs: appName (required), inline, sessionKey.

osirAppListA
Read-onlyIdempotent
Inspect

osirAppList: List the authenticated user's deployed Osir apps with their live URLs and status. An entry with kind 'agent' is a ready-made AI agent (e.g. Hermes): manage it with the osirAgent* tools, never the osirApp* ones. Requires authentication.

Inputs: sessionKey.

osirAppLogsA
Read-onlyIdempotent
Inspect

osirAppLogs: Get recent logs from an Osir app ('why is my app broken?'). Not available yet for an app on the user's own VPS - the result says so; then use osirAppStatus (qa.findings) instead, and never ask the user for SSH access. Requires authentication.

Inputs: appId (required), tail, sessionKey.

osirAppProvisionDatabaseAInspect

osirAppProvisionDatabase: Provision a managed Postgres database for an Osir app. The connection string is stored as the app's DATABASE_URL secret (encrypted, injected on the next osirAppDeploy) and is NEVER returned. Requires authentication.

Inputs: appId (required), engine, sessionKey.

osirAppSetSecretAInspect

osirAppSetSecret: Set an environment secret for an Osir app (e.g. DATABASE_URL, API_KEY). The value is stored encrypted and injected as an env var on the next osirAppDeploy of the app; it is NEVER returned or logged. Requires authentication.

Inputs: key (required), appId (required), value (required), sessionKey.

osirAppStatusA
Read-onlyIdempotent
Inspect

osirAppStatus: Get an Osir app's current status, live URL, and health ('is my app working?'). If the status is BUILD_FAILED, 'recentErrors' explains why so you can fix the source and redeploy. 'qa' is an independent black-box check of the LIVE app after deploy: qa.status PASSED means it loaded and worked; FAILED means it deployed but didn't actually work, and qa.findings lists the problems so you can fix and redeploy. 'ownedMove' tracks a move onto the user's own VPS, which leaves tier and status unchanged while it runs: state MOVING (in progress, stage says where, ~2 minutes in total), MOVED (done - tier reads 'owned'), FAILED or REFUSED (follow this result's message: usually call osirAppDeployToVps again to retry, which never orders a second server; but when the VPS refused the Osir deploy key or its web ports are taken, the user must fix the VPS first, and the message says how). For an app on the user's own VPS (tier 'owned'), health is always UNKNOWN: the platform does not probe the user's server. Use qa to tell whether it works; do not redeploy because of UNKNOWN. Requires authentication.

Inputs: appId (required), sessionKey.

osirSiteDesignBriefA
Read-onlyIdempotent
Inspect

osirSiteDesignBrief: Step 1 of designing a NEW website with OSIR. Validates the brief and returns 'systemPrompt', the structured design brief and constraints YOU must then follow to write one complete self-contained HTML page, plus 'editRules' for later revisions. Call it before osirSitePublish for a new site, then publish the finished page with osirSitePublish. No authentication needed.

Inputs: pageJob (required), audience (required), whatItIs (required), businessName (required), +2 more.

osirSitePublishAInspect

osirSitePublish: Publish a single-page website to a live HTTPS URL on Osir (free tier). ANY complete HTML document works: the user's own site, a page designed in this chat, or one from the osirSiteDesignBrief flow. Calling again with the same name redeploys the new version. For MULTI-FILE sites (separate CSS/JS/images) use osirAppDeploy with all the site's files instead. Then poll osirAppStatus until READY. If the app was moved to the user's own VPS, redeploying under the same name updates it there and keeps its domain. Requires authentication.

Inputs: html (required), name (required), region, sessionKey, +1 more.

payInvoiceAInspect

payInvoice: Stage payment of an outstanding invoice from account balance. Requires authentication. Returns an actionId; present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: invoiceId (required), sessionKey.

previewPaymentFeesA
Read-onlyIdempotent
Inspect

previewPaymentFees: Preview the fees that would be charged for a given payment amount. Requires authentication.

Inputs: amount (required), currency, sessionKey. Returns: fee, total, amount, message, +2 more

registerDomainAInspect

registerDomain: Stage registration of a new domain name. Deducts from account balance. The DNS zone is initialised automatically after registration (asynchronously; if createDnsRecord right after registration reports a missing zone, retry after a few seconds). Pass initializeDnsZone:false to opt out. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve. Owner: pass registrantId (a saved contact from createContact/listContacts) or an inline registrantInfo. For .al domains: first createContact with registryAttributes (see its schema), then pass the returned id as registrantId; ask the user for nameservers rather than guessing. A .al domain ends in pendingCreate until the registry (AKEP) approves it by hand - that is success, not a failure.

Inputs: years (required), domain (required), nameservers (required), autoRenew, +6 more.

renewDomainAInspect

renewDomain: Stage renewal of a domain for a specified number of years. Deducts from account balance. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: years (required), domain (required), sessionKey.

setMailboxPasswordA
Idempotent
Inspect

setMailboxPassword: Set a new password on a mailbox. Never log or store the password. Requires authentication.

Inputs: password (required), mailboxId (required), sessionKey.

spinDomainWordsA
Read-onlyIdempotent
Inspect

spinDomainWords: Generate domain suggestions by spinning/replacing words with similar alternatives.

Inputs: name (required), lang, tlds, position, +2 more.

suggestAlternativesA
Read-onlyIdempotent
Inspect

suggestAlternatives: Suggest alternative domain names if the requested one is unavailable. Legacy; prefer generateDomainSuggestions.

Inputs: domain (required), limit, sessionKey.

transferDomainAInspect

transferDomain: Stage transfer of a domain from another registrar to OSIR. Deducts from account balance. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: domain (required), authCode (required), registrantInfo (required), sessionKey.

unlockDomainA
DestructiveIdempotent
Inspect

unlockDomain: Stage removal of registrar lock from a domain to allow transfers. DESTRUCTIVE: reduces domain security. Returns an actionId: present the summary to the user, then call executeConfirmedAction with the actionId if they approve.

Inputs: domain (required), sessionKey.

updateContactA
Idempotent
Inspect

updateContact: Update an existing contact's information. Requires authentication. Only the fields you provide are changed; omitted fields keep their current values. Get the contactId from listContacts. Returns the updated contact. To make a contact usable as a .al registrant, send registryAttributes (see createContact).

Inputs: contactId (required), city, email, phone, +10 more.

updateDnsRecordA
Idempotent
Inspect

updateDnsRecord: Update an existing DNS record. Requires authentication. Only the fields you provide are changed; omitted fields keep their current values. Get the recordId from listDnsRecords. Returns the updated record.

Inputs: domain (required), recordId (required), ttl, name, +4 more.

updateDomainAutoRenewBInspect

updateDomainAutoRenew: Enable or disable auto-renewal for a domain.

Inputs: domain (required), enabled (required), sessionKey.

updateDomainPrivacyAInspect

updateDomainPrivacy: Enable or disable WHOIS privacy protection for a domain.

Inputs: domain (required), enabled (required), sessionKey.

updateNameserversAInspect

updateNameservers: Update nameservers for a domain. Replaces the current nameserver set with the given list.

Inputs: domain (required), nameservers (required), sessionKey.

validateDomainNameA
Read-onlyIdempotent
Inspect

validateDomainName: Validate if a domain name format is correct. No authentication required.

Inputs: domain (required).

verifyAccountA
Idempotent
Inspect

verifyAccount: Verify a newly created OSIR account with the code from the verification email; step 2 of onboarding, no authentication required. The code is the same token as the email link, so the principal can relay it to their agent. On success the account becomes ACTIVE and billable actions are unlocked. If the code expired, call createAccount again with the same email to get a fresh one.

Inputs: code (required), accountId (required). Returns: status, nextSteps

verifyMailDnsB
Read-onlyIdempotent
Inspect

verifyMailDns: Check that a mail domain's DNS records resolve; activates the domain for email when all records are found. Returns any still-missing records. Requires authentication.

Inputs: domain (required), sessionKey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search for, purchase, connect, and verify custom domains end to end, including setting up email records, configuring forwarding, diagnosing drift, and confirming TLS issuance without handling DNS records directly. It offers twelve hosted tools covering domain availability, registration orders, provider discovery, and account-wide connection inventory.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to check domain availability, register and renew domains, and manage DNS records, contacts, and transfers through a registrar API.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      domain-suite-mcp is an MCP server that gives AI agents full autonomous control over the domain lifecycle. From checking availability and registering domains to managing DNS records, SSL certificates, and email authentication across Porkbun, Namecheap, GoDaddy, and Cloudflare through a unified set of 21 tools.
      21
      24
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.