Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

OSIR Domain Registrar

✓ service owner · osir.com

by Osir-Incversion 2.5.6i★ 0iRuns in the cloudOfficial site ↗
Registry namecom.osir/domain-registrar

How to install

What it does

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

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Developer tools

Use together with

Skills that teach the AI this kind of work; they work alongside this one

rea

Reverse engineer anything with agents, from app behavior down to native binaries.

by morluto★ 467,2351 skills

Skill · How-to guide

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

by multica-ai★ 234,1251 skills

Skill · How-to guideNo license stated

graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

by Graphify-Labs★ 149,8731 skills

Skill · How-to guide

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-18

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 4/4 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install OSIR Domain Registrar. Follow https://mcp.popnx.com/i/osir-domain-registrar.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/4 checks · What you ask goes through the maker’s server (be.osir.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameOSIR Domain Registrar
    Remote MCP server URL · Addresshttps://be.osir.com/mcp/http

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsOSIR Domain Registrar

  4. Try it

    Use OSIR Domain Registrar and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using OSIR Domain Registrar or shows a OSIR Domain Registrar tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameOSIR Domain Registrar
    Connection · Addresshttps://be.osir.com/mcp/http
  3. Pick OSIR Domain Registrar in a chat

    Start a new chat and pick OSIR Domain Registrar from your plugins before typing

  4. Try it

    Use OSIR Domain Registrar and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using OSIR Domain Registrar or shows a OSIR Domain Registrar tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user domain-registrar https://be.osir.com/mcp/http
  3. Type /mcp in Claude Code

    You should see OSIR Domain Registrar listed as connected

  4. Try it

    Use OSIR Domain Registrar and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using OSIR Domain Registrar or shows a OSIR Domain Registrar tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use OSIR Domain Registrar and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using OSIR Domain Registrar or shows a OSIR Domain Registrar tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use OSIR Domain Registrar and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using OSIR Domain Registrar or shows a OSIR Domain Registrar tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://be.osir.com/mcp/http

JSON settings are under “For developers” below

Stuck? Ask people who use OSIR Domain Registrar💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user domain-registrar https://be.osir.com/mcp/http

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "domain-registrar": {
      "url": "https://be.osir.com/mcp/http"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "domain-registrar": {
      "type": "http",
      "url": "https://be.osir.com/mcp/http"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Verified domain
✓ osir.com
Licencei
Apache-2.0
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
2.5.6
Published to registryi
Nov 18, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 18, 2026
Maker
Osir-Inc
Website
osir.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • addPrefixToDomain

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

  • addSshKey

    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 bui

  • addSuffixToDomain

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

  • buildVpsInstance

    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 COMPL

  • bulkDomainSuggestions

    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"; c

  • cancelTransfer

    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.

  • changeVpsPaymentTerm

    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.

  • checkDeviceLoginStatus

    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 argu

  • checkDomainAvailability

    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')

  • checkHostAvailability

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

  • checkKeywordAvailability

    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.

  • checkKeywordAvailabilitySummary

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

  • countMyVpsInstances

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

  • createAccount

    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 v

  • createContact

    createContact: Create a new contact for use with domain registrations. Requires authentication. Returns the created contact including its id for assignment to domains.

  • createDnsRecord

    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.

  • createHost

    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.

  • createMailbox

    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 e

  • createPaymentSession

    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 (

  • deleteContact

    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.

  • deleteDnsRecord

    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.

  • deleteHost

    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.

  • deleteMailbox

    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 appro

  • deleteSshKey

    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 actionI

  • deleteVpsInstance

    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.

  • enableMailDomain

    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. Requir

  • executeConfirmedAction

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

  • fundBalanceWithSharedPaymentToken

    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 network

  • generateDomainSuggestions

    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.

  • getAccountBalance

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

  • getAccountSummary

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

  • getAuthStatus

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

  • getContact

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

  • getContactsForDomain

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

  • getDedicatedServerCatalog

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

  • getDnsRecord

    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.

  • getDomainAuditTrail

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

  • getDomainExtensions

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

  • getDomainInfo

    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 f

  • getDomainPricing

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

  • getHostingBundle

    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 m

  • getHostsForDomain

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

  • getInvoiceDetails

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

  • getInvoiceStatistics

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

  • getMailDnsRecords

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

  • getMailboxQuote

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

  • getMailboxUsage

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

  • getMyAuditLogs

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

  • getMyProfile

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

  • getPaymentTransactions

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

  • getProductCatalog

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

  • getRecentActivity

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

  • getTransferQuote

    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.

  • getTransferStatus

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

  • getVpsInstanceDetails

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

  • getVpsPackageDetails

    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.

  • initializeDnsZone

    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 o

  • initiateTransfer

    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 balan

  • listCategorizedTlds

    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/restric

  • listContacts

    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.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain osir.com (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • – Not applicable

    Has a licence

    Not applicable: a cloud server run by the owner of osir.com; you don't run code from the repo

  • ✓ Pass

    Endpoint responds

    Responded in 280 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 60 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/osir-domain-registrar.svg)](https://mcp.popnx.com/en/servers/osir-domain-registrar)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Developer toolsi

  • More stars than 0% of the other 6116 servers in this category
  • Published to the registry more recently than 97% of the other 6116 servers in this category
  • Basic checks equal to or better than 99% of the other 6116 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is OSIR Domain Registrar safe?

It passed 4 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (2.5.6) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

by ahmedkhaleel2004Widely used★ 19KUpdated 2 months ago

Runs in the cloud✓ service owner · gitdiagram.comTried by the PopNx team

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

by AppllamaWidely used★ 5.2KUpdated 3 months ago

Runs in the cloud✓ service owner · appllama.io

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

by repowise-devWidely used↓ 6.5K/wk★ 8.2K Stars for the whole repoUpdated 6 days ago

Computer or cloud✓ service owner · repowise.dev
Compared with similar ones
This one
OSIR Domain Registrar
GitDiagramAppllamaCloudflare MCPOmnaraRepowise
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoYesNoNo
Basic checks4/44/44/44/44/45/5
LicenseApache-2.0MITMITApache-2.0Apache-2.0AGPL-3.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

OSIR Agent Platform

AI integration servers for the OSIR domain registrar. Connect Claude, ChatGPT, or any AI assistant to real domain, DNS, VPS, billing, and account operations — either as individual tools (MCP) or as task-solving specialist agents (A2A).

Two servers, one shared backend client library:

ServerPortProtocolWhat it gives an AI
MCP Server8081Model Context Protocol (SSE + Streamable HTTP)103 fine-grained tools (checkDomainAvailability, registerDomain, createDnsRecord, createMailbox, osirSitePublish, …) + 11 guided prompts
A2A Server8082Google Agent-to-Agent (JSON-RPC 2.0)9 specialist agents with 89 skills and an orchestrator for multi-step workflows

Use MCP when one assistant should call individual operations. Use A2A when you want to hand a whole task ("set up example.com with DNS and check my balance") to agents that coordinate the work.


What is MCP?

MCP (Model Context Protocol) is an open standard that connects AI assistants to external tools and data. An MCP server publishes a set of callable tools; any MCP client — Claude Desktop, Cursor, Copilot, or a custom agent — can discover and invoke them. OSIR implements an MCP server purpose-built for domain and infrastructure management, which is what makes it an AI-native registrar rather than a traditional one with a chat box bolted on.

Connect OSIR to Claude

In Claude, open Settings → Connectors → Add custom connector, then pick one of two setups:

Option A: No sign-in (recommended)Option B: OAuth
Server URLhttps://be.osir.com/mcp/httphttps://be.osir.com/mcp/oauth
AuthenticationNo sign-inSign in now
OAuth client—Use your own OAuth client, Client ID mcp-client, secret blank
LoginIn the chat, one conversation at a time (below)Browser login when you add the connector; the connector stays signed in

For Option B, don't pick "Use Claude's published identity" or "Register automatically". OSIR doesn't support either one.

Option A: signing in happens inside the conversation. The first time your assistant needs an authenticated tool, it starts a device login: you get a link to auth.osir.com and a short code, you approve in your browser, and the assistant continues with a session scoped to that conversation. Sessions are deliberately short-lived (they expire after ~30 minutes of inactivity, 8 hours maximum) and end instantly when you say "log me out" — so a connected chat never holds standing access to your domains, servers, and billing.

The same URL works in any MCP client that supports a remote (streamable HTTP) server and can drive the in-chat device login.

Self-hosting note: /mcp/oauth always requires OAuth: it returns 401 with an RFC 9728

challenge. The URL-only /mcp/http needs MCP_OAUTH_CHALLENGE_ENABLED=false. If you leave

that at its default (true), every MCP path requires OAuth. Session lifetimes

are tunable via MCP_SESSION_IDLE_MINUTES and MCP_SESSION_MAX_HOURS.

What your assistant can do
CapabilityExample request
Search availability"Is coolstartup.io available, and what does it cost?"
Register a domain"Register it for two years with WHOIS privacy."
Manage DNS"Point it at 192.0.2.10 and add my email records."
Renew and transfer"Renew everything expiring in the next 30 days."
Provision a VPS"Spin up a 2 vCPU server in Frankfurt running Ubuntu."
Host email"Enable email on example.com and create info@ with a 10 GB mailbox."

Running the servers yourself

Want to host your own instance or develop against the code? Requires Java 21; Gradle is bundled via the wrapper.

# Run the MCP server (port 8081)

./gradlew :mcp-server:quarkusDev

Run the A2A server (port 8082)

./gradlew :a2a-server:quarkusDev

Copy .env.example to .env and adjust if you're pointing at your own backend/KeyCloak. Everything defaults to the public OSIR endpoints, so the servers run out of the box.

Connect an MCP client (Claude Desktop / Claude Code)

Add to your client's MCP config (e.g. claude_desktop_config.json):

{

"mcpServers": { "osir": { "url": "http://localhost:8081/mcp/sse" } } }

Restart the client and the OSIR tools appear. Then just ask:

"Is pizzashqip.al available? If not, suggest alternatives."

"List all my domains and show which expire in the next 30 days."

"Add an A record pointing example.al to 203.0.113.10 and a CNAME for www."

Most operations need authentication — ask the assistant to *"log me in to OSIR using the device flow"* and it walks you through browser-based OAuth (KeyCloak, RFC 8628).

Call the A2A server
# Discover the agents

curl http://localhost:8082/.well-known/agents | jq '.[].name'

Send a task (the platform routes it to the right specialist)

curl -X POST http://localhost:8082/a2a \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{ "jsonrpc": "2.0", "id": "1", "method": "tasks/send", "params": { "message": { "role": "user", "parts": [{"type": "text", "text": "Check if example.com is available"}] } } }'

Tasks stream over POST /a2a/stream (SSE), support multi-turn input-required flows, and the orchestrator decomposes complex requests across agents (max 15 steps).


What you can do

Domains — availability, registration, renewal, transfer, lock/unlock, auto-renew, WHOIS privacy, nameservers, AI-powered name suggestions. DNS — list/create/update/delete records. VPS — browse packages and locations, order, manage, panel login. Billing — balance, invoices, payments, fee previews, domain pricing. Contacts, Transfers, Hosts, Audit logs, Account profile & summary.

Full tool/skill catalog, example conversations, and end-to-end walkthroughs are in [GUIDE.md](docs/GUIDE.md).

Tools

113 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 - Stage a change of the payment term (billing cycle) for a VPS instance; confirm with executeConfirmedAction.
  • 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 - Stage removal of an SSH key from your account; confirm with executeConfirmedAction.
  • 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.
  • fundBalanceWithSharedPaymentToken - Stage adding funds to the balance by charging a Stripe Shared Payment Token the customer granted to OSIR, so an agent can pay for a purchase without sending anyone to a checkout page.
  • 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 (builds are free; going live runs on a VPS).
  • 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 quotaBytes.
  • 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 wit

Only the beginning is shown; read the rest in the repo