What is the OSIR Domain Name MCP Server?
The OSIR MCP server is a remote Model Context Protocol server run by OSIR, an ICANN-accredited domain registrar (IANA ID 4332). It gives any MCP client full domain lifecycle access: search, register, renew, transfer, DNS, WHOIS privacy, plus VPS, email hosting, app hosting, and one-page website publishing. It exposes 105 tools, 11 guided prompts, and the same operations over the A2A protocol for autonomous agents.
- Remote server, Streamable HTTP, no local install:
https://be.osir.com/mcp/http
- 450+ domain extensions, 3 continents of infrastructure, 99.9999% uptime SLA
- Every purchase is quoted first and executed only after explicit confirmation, so an agent never spends money silently
- Free to connect; you pay only for the domains and services you order
Setup
Connection details
https://be.osir.com/mcp/http
Claude Code
claude mcp add osir --transport http https://be.osir.com/mcp/http
Codex
codex mcp add osir --url https://be.osir.com/mcp/http
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"osir": {
"type": "http",
"url": "https://be.osir.com/mcp/http"
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"osir": {
"type": "http",
"url": "https://be.osir.com/mcp/http"
}
}
}
Claude (web or desktop): Customize, then Connectors, then Add custom connector. Name it OSIR and paste the URL above.
ChatGPT: Settings, then Connectors, then add a custom connector with the same URL.
Gemini CLI
gemini mcp add --transport http osir https://be.osir.com/mcp/http
No credentials are needed to connect. Availability, pricing, and name suggestions work immediately. Account operations ask you to sign in once through a device login link, which also works for headless agents.
What can it do?
| Group | Tools | Examples |
|---|
| Domains and transfers | 23 | checkDomainAvailability, registerDomain, renewDomain, transferDomain, lockDomain, updateNameservers |
| Domain name suggestions | 6 | generateDomainSuggestions, checkKeywordAvailability, spinDomainWords |
| DNS | 6 | listDnsRecords, createDnsRecord, updateDnsRecord, initializeDnsZone |
| Nameserver hosts | 4 | createHost, getHostsForDomain |
| Contacts | 6 | createContact, updateContact, getContactsForDomain |
| VPS and servers | 16 | listVpsPackages, orderVps, buildVpsInstance, addSshKey |
| Apps and hosting | 13 | osirAppDeploy, osirAppLogs, osirSiteDesignBrief, osirSitePublish |
| Email hosting | 11 | enableMailDomain, createMailbox, verifyMailDns |
| Billing and payments | 8 | previewPaymentFees, payInvoice, listInvoices |
| Account and platform | 12 | loginWithDevice, getAccountSummary, getMyAuditLogs |
The 11 prompts guide multi-step flows such as finding and registering a name, moving a domain in, setting up email on a domain, and the website_designer flow that interviews you, writes a one-page site, and publishes it at name.osir.app.
Tools
105 tools, verified against the live server (tools/list on https://be.osir.com/mcp/http).
- addPrefixToDomain - Generate domain suggestions by adding prefixes.
- addSshKey - Store an SSH public key on your account so it can be injected into VPS installs.
- addSuffixToDomain - Generate domain suggestions by adding suffixes.
- buildVpsInstance - Stage an operating system install on a VPS instance.
- bulkDomainSuggestions - Generate domain name suggestions for one or more keywords across a chosen set of TLDs.
- cancelTransfer - Stage cancellation of a pending domain transfer.
- changeVpsPaymentTerm - Change the payment term (billing cycle) for a VPS instance.
- checkDeviceLoginStatus - Poll for device login completion.
- checkDomainAvailability - Check if a domain name is available for registration, with price.
- checkHostAvailability - Check if a host/glue record name is available for creation.
- checkKeywordAvailability - Check keyword availability across all supported TLDs and registries with detailed results.
- checkKeywordAvailabilitySummary - Check keyword availability summary statistics without detailed domain results (faster).
- countMyVpsInstances - Get the total count of VPS instances owned by the authenticated user.
- createAccount - Create a new OSIR customer account.
- createContact - Create a new contact for use with domain registrations.
- createDnsRecord - Create a new DNS record for a domain.
- createHost - Create a new host/glue record (e.g., for custom nameservers).
- createMailbox - Stage creation of a paid mailbox on a mail-enabled domain.
- createPaymentSession - Stage creation of a Stripe payment checkout session to add funds to account balance.
- deleteContact - Stage deletion of a contact.
- deleteDnsRecord - Stage deletion of a DNS record.
- deleteHost - Stage deletion of a host/glue record.
- deleteMailbox - Stage deletion of a mailbox.
- deleteSshKey - Remove an SSH key from your account.
- deleteVpsInstance - Stage deletion/cancellation of a VPS instance.
- enableMailDomain - Enable email hosting on a domain you own.
- executeConfirmedAction - Execute a previously staged destructive or financial action after user approval.
- generateDomainSuggestions - Generate domain name suggestions based on keywords.
- getAccountBalance - Get the current account balance for the authenticated user.
- getAccountSummary - Get a comprehensive summary of the user's account: profile, balance, domain count, VPS count, and pending transfers.
- getAuthStatus - Check whether the current session is authenticated.
- getContact - Get detailed information about a specific contact.
- getContactsForDomain - Get all contacts (registrant, admin, tech, billing) assigned to a domain.
- getDedicatedServerCatalog - Get all available dedicated server configurations with pricing and specifications.
- getDnsRecord - Get details of a specific DNS record.
- getDomainAuditTrail - Get the audit trail (history of all changes) for a specific domain.
- getDomainExtensions - Get all available domain extensions (TLDs) with pricing information.
- getDomainInfo - Get detailed information about a domain including expiration date, nameservers, and status.
- getDomainPricing - Get pricing for domain extensions from the product catalog.
- 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.
- getHostsForDomain - List all host/glue records associated with a domain.
- getInvoiceDetails - Get detailed information about a specific invoice including line items.
- getInvoiceStatistics - Get summary statistics of invoices: total paid, pending, overdue amounts.
- getMailboxQuote - Get a display-only price quote for a mailbox plan.
- getMailboxUsage - Get disk usage per mailbox in bytes, for quota display alongside the plan's quota.
- getMailDnsRecords - Get the DNS records a mail domain needs (MX, SPF, DKIM) for customers managing DNS externally.
- getMyAuditLogs - Get recent audit logs for the authenticated user across all services.
- getMyProfile - Get the authenticated user's profile and account information including name, email, organization, balance, and domain/VPS counts.
- getPaymentTransactions - Get payment transaction history for the authenticated user.
- getProductCatalog - Get the complete product catalog including domain extensions, VPS packages, and dedicated servers.
- getRecentActivity - Get the most recent activity across all domains and services for the user.
- getTransferQuote - Get a transfer price quote for a domain.
- getTransferStatus - Check the current status of a domain transfer.
- getVpsInstanceDetails - Get detailed information about a specific VPS instance including resource usage.
- getVpsPackageDetails - Get detailed information about a specific VPS package including all pricing tiers.
- initializeDnsZone - Initialize (create) the DNS zone for a domain.
- initiateTransfer - Stage initiation of a domain transfer from another registrar.
- listCategorizedTlds - List TLDs from the OSIR catalog that have category and audience metadata populated.
- listContacts - List all contacts for the authenticated user with optional search.
- listDnsRecords - List all DNS records for a domain.
- listInvoices - List invoices for the authenticated user with optional status filtering and pagination.
- listMailboxes - List your mailboxes with plan, payment term, status, and next renewal date.
- listMailDomains - List your domains that are enabled for email hosting, with status and DNS mode.
- listMailPlans - List available email mailbox plans with quotas and prices (monthly and annual).
- listMySshKeys - List the SSH keys stored on your account, with their ids and SHA256 fingerprints.
- listMyVpsInstances - List all VPS instances owned by the authenticated user.
- listPendingTransfers - List all pending incoming (gaining) domain transfers.
- listUserDomains - List all domains owned by the authenticated user.
- listVpsLocations - List available VPS hosting locations (cities/countries) with available packages.
- listVpsOsTemplates - List operating system templates available to install.
- listVpsPackages - List available VPS hosting packages with pricing, specs, and locations.
- lockDomain - Enable registrar lock on a domain to prevent unauthorized transfers.
- loginToVpsPanel - Generate a one-time login URL to the VPS control panel for managing the server.
- loginWithDevice - Start a device authorization login (RFC 8628).
- logout - Log out and revoke the session's tokens at the identity provider immediately.
- orderVps - Stage an order for a new VPS instance.
- osirAppCreateUpload - Create an upload ticket for deploying app source code to OSIR.
- osirAppDelete - Stage deletion of an OSIR app.
- osirAppDeploy - Deploy an app to OSIR (free tier) and get a live HTTPS URL; the app runs isolated in a microVM.
- osirAppGetSource - Get a short-lived signed download URL for a deployed app's current source zip, to patch and redeploy it under the same name.
- osirAppList - List the authenticated user's deployed OSIR apps with their live URLs and status.
- osirAppLogs - Get recent logs from an OSIR app's microVM.
- osirAppMoveToOwned - Move a deployed OSIR app from the shared free tier onto a paid VPS owned by the user.
- osirAppProvisionDatabase - Provision a managed Postgres database for an OSIR app.
- osirAppSetSecret - Set an environment secret for an OSIR app.
- osirAppStatus - Get an OSIR app's current status, live URL, and health.
- osirSiteDesignBrief - Step 1 of designing a website with OSIR: validate the brief and return design instructions.
- osirSitePublish - Publish a single-page website to a live HTTPS URL on OSIR (free tier); any complete HTML document works.
- payInvoice - Stage payment of an outstanding invoice from account balance.
- previewPaymentFees - Preview the fees that would be charged for a given payment amount.
- registerDomain - Stage registration of a new domain name.
- renewDomain - Stage renewal of a domain for a specified number of years.
- setMailboxPassword - Set a new password on a mailbox.
- spinDomainWords - Generate domain suggestions by spinning or replacing words.
- suggestAlternatives - Suggest alternative domain names if the requested one is unavailable.
- transferDomain - Stage transfer of a domain from another registrar to OSIR.
- unlockDomain - Stage removal of registrar lock from a domain to allow transfers.
- updateContact - Update an existing contact's information.
- updateDnsRecord - Update an existing DNS record.
- updateDomainAutoRenew - Enable or disable auto-renewal for a domain.
- updateDomainPrivacy - Enable or disable WHOIS privacy protection for a domain.
- updateNameservers - Update nameservers for a domain.
- validateDomainName - Validate if a domain name format is correct.
- verifyAccount - Verify a newly created OSIR account with the code from the verification email; step 2 of onboarding, no authentication required.
- verifyMailDns - Check that a mail domain's DNS records resolve; activates the domain for email when all records are found.
Example prompts
- "Is brandname.com available? If not, suggest ten alternatives under $20 a year."
- "Register brandname.io for two years with WHOIS privacy on."
- "Point brandname.com at 203.0.113.10 and add a www CNAME."
- "Renew every domain in my account that expires in the next 60 days."
- "Transfer brandname.net from my old registrar. The auth code is XXXX."
- "Enable email on brandname.com and create hello@brandname.com."
- "Design a one-page site for my bakery and publish it."
How does it keep an agent from overspending?
Every tool that costs money returns a quote with the full price, including ICANN fees and payment processing, and then stops. Nothing is charged until the client calls executeConfirmedAction with the quoted action. Domain lock, auto-renew, and privacy toggles are separate explicit tools, so an agent cannot change them as a side effect. All account activity is logged and readable through getMyAuditLogs.
What else is in the box?
- A2A agent card at
https://be.osir.com/.well-known/agent.json with 7 agents and 53 skills for agent-to-agent registration
- REST API with an OpenAPI 3.0 specification at osir.com/en/developers
- CLI at github.com/Osir-Inc/cli with 76 commands
- Full tool reference in the repository's GUIDE.md
Comments