What it does
Register and manage domains, DNS, VPS, email, and self-hosted AI agents with 113 tools. By OSIR.
- Connects 在云端运行
- Account or key No key needed
- Category 开发者工具
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
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.
为什么排在这里
此项在“连接 AI 的应用”标签中,该标签不使用星标,按以下顺序排列
| 1. 在 Claude 连接器目录中 | 否 | |
|---|---|---|
| 2. 团队实测过 | 否 | |
| 3. 适合泰国用户 | 否 | |
| 4. 不计星标的使用量 | 20/100 | 热度 0 · 新鲜度 12 · 仍在响应 8 · 用户喜欢 +0 |
| 5. 登记日期 | 2026-11-18 |
用户喜欢: 0 · 最多加 5 分(每人 1 分),不能用钱买。
质量: 基础检查通过 4/4 项(仅展示,不用于排序)
安装
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 OSIR Domain Registrar。按照 https://mcp.popnx.com/i/osir-domain-registrar.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 4/4 项检查 · 你的提问会经过开发者的服务器(be.osir.com) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
打开 Claude 的 Connectors 页面
CustomizeConnectors
点击“Add” → “Custom” → “Web”,填写这 2 项
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Name · 名称OSIR Domain RegistrarRemote MCP server URL · 地址https://be.osir.com/mcp/http在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
在聊天中开启
+ConnectorsOSIR Domain Registrar
试一试
用 OSIR Domain Registrar 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 OSIR Domain Registrar,或回答中出现 OSIR Domain Registrar 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
能否连接 ChatGPT 取决于方案
完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页
在网页版 ChatGPT 打开添加 MCP 的页面
Plugins+Add custom MCP server
填写名称和地址
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
Name · 名称OSIR Domain RegistrarConnection · 地址https://be.osir.com/mcp/http在聊天中选择 OSIR Domain Registrar
开启新聊天,输入前先从插件列表中选择 OSIR Domain Registrar
试一试
用 OSIR Domain Registrar 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 OSIR Domain Registrar,或回答中出现 OSIR Domain Registrar 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --transport http --scope user domain-registrar https://be.osir.com/mcp/http在 Claude Code 中输入 /mcp
应能看到 OSIR Domain Registrar 在列表中并显示已连接
试一试
用 OSIR Domain Registrar 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 OSIR Domain Registrar,或回答中出现 OSIR Domain Registrar 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 OSIR Domain Registrar 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 OSIR Domain Registrar,或回答中出现 OSIR Domain Registrar 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 OSIR Domain Registrar 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 OSIR Domain Registrar,或回答中出现 OSIR Domain Registrar 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://be.osir.com/mcp/httpJSON 设置在下方“开发者专用”中
开发者专用:终端命令和 JSON 设置
通过网页连接
Claude Code
claude mcp add --transport http --scope user domain-registrar https://be.osir.com/mcp/httpCursor (~/.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"
}
}
}这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
它能做什么
工具名称和描述与服务器在 2026年11月18日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
addPrefixToDomainaddPrefixToDomain: Generate domain suggestions by adding prefixes to a base name.
addSshKeyaddSshKey: 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
addSuffixToDomainaddSuffixToDomain: Generate domain suggestions by adding suffixes to a base name.
buildVpsInstancebuildVpsInstance: 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
bulkDomainSuggestionsbulkDomainSuggestions: 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
cancelTransfercancelTransfer: 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.
changeVpsPaymentTermchangeVpsPaymentTerm: 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.
checkDeviceLoginStatuscheckDeviceLoginStatus: 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
checkDomainAvailabilitycheckDomainAvailability: 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')
checkHostAvailabilitycheckHostAvailability: Check if a host/glue record name is available for creation. Requires authentication. Returns whether the hostname is free; call before createHost.
checkKeywordAvailabilitycheckKeywordAvailability: 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.
checkKeywordAvailabilitySummarycheckKeywordAvailabilitySummary: Check keyword availability across TLDs and registries. Summary statistics only (no per-domain results), faster than checkKeywordAvailability.
countMyVpsInstancescountMyVpsInstances: Get the total count of VPS instances owned by the authenticated user. Requires authentication.
createAccountcreateAccount: 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
createContactcreateContact: Create a new contact for use with domain registrations. Requires authentication. Returns the created contact including its id for assignment to domains.
createDnsRecordcreateDnsRecord: 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.
createHostcreateHost: 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.
createMailboxcreateMailbox: 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
createPaymentSessioncreatePaymentSession: 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 (
deleteContactdeleteContact: 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.
deleteDnsRecorddeleteDnsRecord: 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.
deleteHostdeleteHost: 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.
deleteMailboxdeleteMailbox: 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
deleteSshKeydeleteSshKey: 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
deleteVpsInstancedeleteVpsInstance: 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.
enableMailDomainenableMailDomain: 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
executeConfirmedActionexecuteConfirmedAction: Execute a previously staged destructive or financial action after user approval. The action expires after 5 minutes and can only be executed once.
fundBalanceWithSharedPaymentTokenfundBalanceWithSharedPaymentToken: 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
generateDomainSuggestionsgenerateDomainSuggestions: 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.
getAccountBalancegetAccountBalance: Get the current account balance for the authenticated user. Requires authentication.
getAccountSummarygetAccountSummary: Get a comprehensive summary of the user's account: profile, balance, domain count, VPS count, and pending transfers. Requires authentication.
getAuthStatusgetAuthStatus: Check whether the current session is authenticated. Returns authenticated status and token expiry. Optional: sessionKey (from checkDeviceLoginStatus).
getContactgetContact: Get detailed information about a specific contact. Requires authentication. Get the contactId from listContacts. Returns name, email, phone, organization, and address.
getContactsForDomaingetContactsForDomain: Get all contacts (registrant, admin, tech, billing) assigned to a domain. Requires authentication. Returns the contact assigned to each role.
getDedicatedServerCataloggetDedicatedServerCatalog: Get all available dedicated server configurations with pricing and specifications. No authentication required.
getDnsRecordgetDnsRecord: 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.
getDomainAuditTrailgetDomainAuditTrail: Get the audit trail (history of all changes) for a specific domain. Requires authentication.
getDomainExtensionsgetDomainExtensions: Get all available domain extensions (TLDs) with pricing information. No authentication required.
getDomainInfogetDomainInfo: 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
getDomainPricinggetDomainPricing: Get pricing for domain extensions from the product catalog. Requires authentication.
getHostingBundlegetHostingBundle: 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
getHostsForDomaingetHostsForDomain: List all host/glue records associated with a domain. Requires authentication. Returns each host name and its IP addresses.
getInvoiceDetailsgetInvoiceDetails: Get detailed information about a specific invoice including line items. Requires authentication.
getInvoiceStatisticsgetInvoiceStatistics: Get summary statistics of invoices: total paid, pending, overdue amounts. Requires authentication.
getMailDnsRecordsgetMailDnsRecords: Get the DNS records a mail domain needs (MX, SPF, DKIM, ...), for customers managing DNS externally. Requires authentication.
getMailboxQuotegetMailboxQuote: Get a display-only price quote for a mailbox plan. The backend re-derives the authoritative price at purchase. Requires authentication.
getMailboxUsagegetMailboxUsage: Get disk usage per mailbox in bytes, for quota display alongside the plan's quotaBytes. Requires authentication.
getMyAuditLogsgetMyAuditLogs: Get recent audit logs for the authenticated user across all services. Requires authentication.
getMyProfilegetMyProfile: Get the authenticated user's profile and account information including name, email, organization, balance, and domain/VPS counts. Requires authentication.
getPaymentTransactionsgetPaymentTransactions: Get payment transaction history for the authenticated user. Requires authentication.
getProductCataloggetProductCatalog: Get the complete product catalog including domain extensions, VPS packages, and dedicated servers. No authentication required.
getRecentActivitygetRecentActivity: Get the most recent activity across all domains and services for the user. Requires authentication.
getTransferQuotegetTransferQuote: 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.
getTransferStatusgetTransferStatus: Check the current status of a domain transfer. Requires authentication. Returns status, request date, current registrar, and expected completion.
getVpsInstanceDetailsgetVpsInstanceDetails: Get detailed information about a specific VPS instance including resource usage. Requires authentication.
getVpsPackageDetailsgetVpsPackageDetails: 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.
initializeDnsZoneinitializeDnsZone: 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
initiateTransferinitiateTransfer: 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
listCategorizedTldslistCategorizedTlds: 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
listContactslistContacts: 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.
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 osir.com 验证(注册中心会核实域名所有权)
- ✓ 通过
仍在维护
代码最后更新于昨天
- – 不适用
有许可证
不适用:由 osir.com 的所有者自己运行的云端服务器,你不会运行仓库里的代码
- ✓ 通过
端点有响应
在 280 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 60 个工具描述,未发现针对 AI 的隐藏指令
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/osir-domain-registrar)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 6116 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 6116 个服务器的 97% 更新
- 基础检查结果等于或优于此分类中其他 6116 个服务器的 99%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
OSIR Domain Registrar 安全吗?
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于昨天,最新版本(2.5.6)于昨天进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
有什么可以替代它?
同一分类中有:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 本项 OSIR Domain Registrar | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 运行位置 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 云端或安装在电脑上都可以 |
| 需要密钥 | 否 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 是 | 否 | 否 |
| 基础检查 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 许可证 | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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:
| Server | Port | Protocol | What it gives an AI |
|---|---|---|---|
| MCP Server | 8081 | Model Context Protocol (SSE + Streamable HTTP) | 103 fine-grained tools (checkDomainAvailability, registerDomain, createDnsRecord, createMailbox, osirSitePublish, …) + 11 guided prompts |
| A2A Server | 8082 | Google 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 URL | https://be.osir.com/mcp/http | https://be.osir.com/mcp/oauth |
| Authentication | No sign-in | Sign in now |
| OAuth client | — | Use your own OAuth client, Client ID mcp-client, secret blank |
| Login | In 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/oauthalways requires OAuth: it returns401with an RFC 9728
challenge. The URL-only
/mcp/httpneedsMCP_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_MINUTESandMCP_SESSION_MAX_HOURS.
What your assistant can do
| Capability | Example 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