OSIR Domain Name MCP Server

MCP开发工具

提供方 Osir

开发工具 HTTP · 远程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

Remote MCP server from OSIR, an ICANN-accredited registrar: 105 tools and 11 prompts to search, register, renew, transfer, and manage domains, DNS, VPS, email, and websites from Claude, ChatGPT, Cursor, or any MCP client

一句话选型结论

按资料字段整理

OSIR Domain Name MCP Server 属于开发工具类 MCP 服务器,HTTP · 远程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式HTTP · 远程 鉴权OAuth 授权 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 105 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量105暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

domain dns vps website builder remote mcp streamable http claude chatgpt

支持客户端

适用场景

domaindnsvps

安装与配置

HTTP · 远程 OAuth 授权
连远程 HTTPS 端点,通常为 Streamable HTTP
http://localhost:8081/mcp/sse

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 105 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 105 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
OSIR Domain Name MCP Server当前 105 HTTP · 远程 远程部署 有 未标注
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Osir上游标注的维护方 Osir
分类开发工具本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · java本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

18.8 KB
来自项目仓库与上游目录的原文,未做删改

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

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.```bash

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`):```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```bash

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

## Tools

106 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 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 (PENDING_DNS or ACTIVE) and DNS mode.
- **listMailPlans** - List available email mailbox plans with quotas and prices (monthly and annual, in cents).
- **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 (VirtFusion) for managing the server.
- **loginWithDevice** - Start a device authorization login (RFC 8628).
- **logout** - Log out: revokes 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. Redeploying an app that was moved to the user's own VPS updates it there and keeps its domain.
- **osirAppGetSource** - Get a short-lived signed download URL for an Osir app's current source zip - use this to make edits to a deployed app without the user re-attaching the project: download, patch the files, then osirAppCreateUpload (PUT the new zip) and osirAppDeploy under the SAME name; the platform rebuilds and, for owned-tier apps, auto-ships the new version to the user's box.
- **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 ('why is my app broken?').
- **osirAppDeployToVps** - Deploy a live Osir app onto a VPS the user owns, moving it off the shared free tier: attach one they already have (instanceId, spends nothing) or order one (packageId, gated). The platform ships the app over its own deploy key - never SSH, never an install script.
- **osirAppProvisionDatabase** - Provision a managed Postgres database for an Osir app.
- **osirAppSetSecret** - Set an environment secret for an Osir app (e.g.
- **osirAppStatus** - Get an Osir app's current status, live URL, and health ('is my app working?').
- **osirSiteDesignBrief** - Step 1 of designing a website with OSIR.
- **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. Republishing a site that was moved to the user's own VPS updates it there.
- **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/replacing words.
- **suggestAlternatives** - Suggest alternative domain names if the requested one is unavailable (legacy method).
- **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.

---

## Build, test, deploy```bash
./gradlew build        # build all modules + run tests
./gradlew test         # tests only

docker-compose up -d   # run both servers in containers

The provided docker-compose.yml, build-and-deploy.bat, and the CI workflow reference a
placeholder container registry (registry.example.com) — point them at your own.
See DEPLOYMENT.md for the production checklist (PostgreSQL, TLS, scaling).

Configuration

All settings are environment variables with sensible defaults — nothing secret is committed.

Variable Default Description
OSIR_BACKEND_URL https://be.osir.com Backend API
KEYCLOAK_URL https://auth.osir.com KeyCloak auth server
KEYCLOAK_REALM osir KeyCloak realm
KEYCLOAK_CLIENT_ID osir-cli OAuth client ID
CORS_ORIGINS https://osir.com,… Allowed CORS origins
A2A_SIGNING_SECRET (empty) Optional HMAC-SHA256 request signing
SENTRY_DSN (empty) Optional crash reporting to a Sentry-protocol endpoint (GlitchTip); empty = off
SENTRY_ENVIRONMENT production Environment label on reported events

See .env.example for the full list.

Project layout```

common/ Shared library — 12 services, 9 REST clients, ~174 models
mcp-server/ Quarkus MCP server — 106 tools, 11 prompts, 2 resources
a2a-server/ Quarkus A2A server — 9 agents, 89 skills, JSON-RPC, JPA task persistence
```

Both servers depend on common, so a backend operation is implemented once and exposed two ways.

Documentation

  • GUIDE.md — complete usage guide, tool reference, walkthroughs
  • WEBSITE-DESIGN.md — AI website design: customer guide, use cases, frontend integration
  • DEVELOPING.md — repo layout, build/run commands, architecture notes
  • VPS-OS-BUILD.md — ordering a VPS with an OS, SSH keys, reinstall, and
    the OSIR APP DEPLOY flow. Read this before touching the VPS tools: ordering and building are two
    separate VirtFusion steps, and orderVps alone hands over a server with no operating system.
  • A2A-API-REFERENCE.md — A2A protocol spec (methods, errors, agents)
  • A2A-ARCHITECTURE.md — A2A design document
  • A2A-CONFIRMATION-GATE-SPEC.md — staging destructive ops
    behind executeConfirmedAction
  • DEPLOYMENT.md — production deployment checklist

License

Apache License 2.0.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
OSIR Domain Name MCP Server 怎么安装?

在客户端按下面的安装命令接入:http://localhost:8081/mcp/sse。装完在客户端配置里引用同一个包或端点。

OSIR Domain Name MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

OSIR Domain Name MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

OSIR Domain Name MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

OSIR Domain Name MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Windsurf、Gemini CLI;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

OSIR Domain Name MCP Server 能提供哪些能力?

资料显示约 105 个工具;能力标签包括 domain、dns、vps、website builder、remote mcp、streamable http。具体工具清单以官方文档为准。

OSIR Domain Name MCP Server 需要什么运行环境?

运行时为 java;属于远程端点,不需要在本地装运行时。

OSIR Domain Name MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。