AgentDomains

AgentDomains MCP サーバー

AgentDomains の MCP サーバーです。AI エージェントが構築するウェブサイトや API に、無料のドメインを提供します。MCP に対応したあらゆるエージェントに、makes.fyi または agentdomains.co 配下の実際のホスト名と、DNS レコード、HTTPS、URL 転送、リバースプロキシ機能を提供します。

実行方法は 2 通りあります。npx を使って stdio 経由でローカル実行する方法と、ホスト型のリモートエンドポイント https://mcp.agentdomains.co に接続する方法です。

インストール（stdio）

インストールは不要です。npx が必要に応じて取得します。

AGENTDOMAINS_API_KEY=adom_… npx -y agentdomains-mcp

Claude Code

claude mcp add agentdomains --env AGENTDOMAINS_API_KEY=adom_… -- npx -y agentdomains-mcp

Claude Desktop およびその他の設定ファイルを使うクライアント

claude_desktop_config.json（またはクライアントに相当する設定ファイル）に追加します。

{
  "mcpServers": {
    "agentdomains": {
      "command": "npx",
      "args": ["-y", "agentdomains-mcp"],
      "env": { "AGENTDOMAINS_API_KEY": "adom_…" }
    }
  }
}

リモートエンドポイント

https://mcp.agentdomains.co

Streamable HTTP を使用します。JSON-RPC を POST で送信し、Authorization ヘッダーにキーを含めてください。

curl -s https://mcp.agentdomains.co \
  -H 'Authorization: Bearer adom_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Claude Code では、claude mcp add --transport http agentdomains https://mcp.agentdomains.co --header "Authorization: Bearer adom_…" を実行します。

設定

変数	用途
AGENTDOMAINS_API_KEY	API キー（adom_…）です。~/.agentdomains/config.json の api_key にフォールバックします。
AGENTDOMAINS_API_URL	API のベース URL を上書きします。デフォルトは https://api.agentdomains.co です。

すでに Go CLI をお使いの場合は、~/.agentdomains/config.json が自動的に読み込まれるため、環境変数は不要です。

まだキーをお持ちでない場合は、signup ツールを呼び出してください。認証情報は不要で、キーが返されます。キーは一度しか表示されず、後から取得することはできません。すぐに保存してください。アカウントは仮登録の状態です。attach_email でメールアドレスを登録し、30 日以内に確認しない場合、アカウントとそのドメインは削除されます。

API キーがログに記録されたり、表示されたり、ツールの出力に含まれたりすることはありません。

ツール

ツール	エンドポイント	説明
check_availability	GET /v1/available	ラベルは空いていますか？キーは不要です。
signup	POST /v1/signup	アカウントを作成し、API キーを取得します（一度だけ表示されます）。キーは不要です。
whoami	GET /v1/whoami	アカウントの状態、メールアドレス、割り当て量、使用量を確認します。
attach_email	POST /v1/account/email	メールアドレスを登録し、確認リンクを送信します。
claim_domain	POST /v1/subdomains	label.domain を登録します。最初のレコードを任意で設定できます。
list_domains	GET /v1/subdomains	アカウント上のすべての名前を一覧表示します。
get_domain	GET /v1/subdomains/{label}	1 つの名前、そのレコード、転送／プロキシの状態を取得します。
delete_domain	DELETE /v1/subdomains/{label}	取り消せません — 名前とそのレコードを完全に削除します。
add_dns_record	POST /v1/subdomains/{label}/records	A、AAAA、CNAME、または TXT レコードを追加します。
delete_record	DELETE /v1/subdomains/{label}/records/{id}	取り消せません — 名前は残したまま、1 つのレコードを削除します。ID は get_domain で取得できます。
add_acme_challenge	POST /v1/subdomains/{label}/records	Let's Encrypt の DNS-01 用に _acme-challenge に TXT レコードを設定します。
set_forward	PUT /v1/subdomains/{label}/forward	名前を URL にリダイレクトします。その名前のアドレスレコードを置き換えます。
remove_forward	DELETE /v1/subdomains/{label}/forward	転送を停止します。
set_proxy	PUT /v1/subdomains/{label}/proxy	エッジ経由でバックエンドを配信し、TLS を終端します。その名前のアドレスレコードを置き換えます。
remove_proxy	DELETE /v1/subdomains/{label}/proxy	プロキシを停止します。
delegate_nameservers	PUT /v1/subdomains/{label}/ns	名前を独自のネームサーバーに委任します。
delete_account	DELETE /v1/account[?force=true]	取り消せません — アカウントを閉鎖してそのキーを無効にします。名前を保有している間は、force を指定しない限り拒否されます。
upgrade_to_pro	POST /v1/billing/checkout	Pro 用の Stripe チェックアウトリンクを発行します（名前 100 個、月額 $5 または年額 $48）。料金は発生しません。人間がリンクを開いて支払います。
manage_billing	POST /v1/billing/portal	Pro アカウント用の Stripe 請求ポータルリンクを発行します（カード、請求書、請求間隔、解約）。

ラベル単位の各ツールでは、任意の domain（デフォルトの makes.fyi、または agentdomains.co）を指定できます。

転送またはプロキシを設定すると、そのホスト名の所有権が移ります。 ラベル自体の A／AAAA／CNAME レコードは同じ呼び出しで削除され、replaced_records として返されるため、何が移動したかをユーザーに伝えてください。サブラベルのレコード（www.myapp.makes.fyi）と TXT レコードはそのまま残ります。転送の開始に失敗した場合、置き換えられたレコードは新しい ID で復元されます。

名前の取得と最初のレコードの設定は一体です。 claim_domain に指定したレコードを作成できない場合、名前は取得されません。レコードを修正して再度呼び出してください。アカウントがすでに保有している名前を再取得しようとすると、owned:true を含む 409 が返されます。これはそのまま続行してよいことを意味します。

HTTPS について

ここでは「SSL を設定して」は 1 つの操作ではありません。正確には、次の 2 つの方法があります。

• set_proxy — エッジが独自の証明書で TLS を終端し、バックエンドにプロキシします。オリジンにインストールするものはありません。
• add_acme_challenge — DNS-01 TXT レコードを公開し、独自の ACME クライアントで Let's Encrypt 証明書を発行できるようにします（ワイルドカードや、パブリックポート 80 を使えないホストで必要です）。 一般公開の Web サーバーなら HTTP-01 を使用でき、DNS レコードはまったく必要ありません。

互換性

どの MCP クライアントでも動作します。一般的なクライアントでの設定例を確認済みです。

• Claude Code — 上記のとおり、claude mcp add（stdio または --transport http）。
• Claude Desktop — claude_desktop_config.json の mcpServers ブロック。
• OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "agentdomains-mcp"]})、またはリモート URL に接続する MCPServerStreamableHttp。
• LangChain / LangGraph — langchain-mcp-adapters：MultiServerMCPClient({"agentdomains": {"command": "npx", "args": ["-y", "agentdomains-mcp"], "transport": "stdio"}})。
• CrewAI — 同じ stdio パラメーターを指定した MCPServerAdapter。
• その他 — stdio 経由で npx -y agentdomains-mcp を指定するか、Streamable HTTP 経由で https://mcp.agentdomains.co を指定してください。

開発

npm install
npm run build     # tsc -> dist/
npm run smoke     # boots dist/index.js, runs initialize + tools/list over stdio

Node 18+ が必要です。ランタイム依存関係は @modelcontextprotocol/sdk のみです。

関連項目

• CLI (Go) — agentdomains コマンド
• エージェントスキル — Claude Code プラグイン
• ドキュメント · HTTP API

ライセンス

FSL-1.1-Apache-2.0 — LICENSE をご覧ください。CLI と同じ条件です。

MCP Registry への登録

このサーバーは、公式の MCP Registry に io.github.tashfeenahmed/agentdomains-mcp として登録されています。PulseMCP、Glama などの エージェントツールディレクトリが参照するインデックスです。メタデータは、このリポジトリの server.json にあります。

公開は手動です（このアカウントでは GitHub Actions が実行されません）。npm の 各リリースで、server.json の version と packages[0].version を package.json に合わせて更新し、 先に npm に公開してから、次を実行してください。

# once: install the publisher (macOS/Linux)
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

./mcp-publisher login github     # device-code flow as the tashfeenahmed GitHub account
./mcp-publisher publish          # uploads server.json
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.tashfeenahmed/agentdomains-mcp"

レジストリは、npm パッケージの mcpName が server.json の name と一致することを確認するため、 server.json に記載する npm のバージョンは、事前に公開しておく必要があります。

docs/publish-mcp-registry.yml は、GitHub OIDC 経由で v* タグに対して同じ処理を行う、任意の GitHub Actions ワークフローです。このファイルを .github/workflows/ に移動し、アカウントで Actions が利用可能な場合にのみ実行されます。