thatmgmt-mcp

thatmgmt-mcp

ThatMgmt ドメイン API をラップする MCP（Model Context Protocol）サーバーです。あらゆる MCP クライアントから、空き状況を確認し、ロック済みの価格見積もりを取得し、登録の準備ができます。公開ツールは登録不要です。 テナント向けツール（ポートフォリオ、提案、ドライラン計画）は API キーを使うと利用できます。何かが不意に実行されることはありません。API に実行エンドポイントはないため、このサーバーは計画と価格提示のみを行い、購入は行いません。

ベース API：https://api.thatmgmt.com 仕様：openapi.json 機械可読ドキュメント：llms-full.txt

検証済みの主張

以下の各主張は、test/ 内のテストで裏付けられています。すべてモックを使用し、ネットワーク、キー、料金は不要です。実際に実行できます：npm test（47 件中 47 件成功）。

主張	裏付けデータ
MCP ツールは 13 個で、そのうち公開ツールは正確に 4 個です	test/tools.test.js の「exposes the expected tool set」で 13 個すべての名前を検証し、「exactly the zero-signup tools are marked public」で tmgmt_health、tmgmt_capabilities、domains_check_availability、domains_get_quote を固定
テナント向けツールは API キーがない場合、フェイルクローズします	test/server.test.js の「refuses tenant tools without an API key」：isError が true で、メッセージに TMGMT_API_KEY が記載される
公開ツールは Authorization ヘッダーを送信しません	test/server.test.js の「public reads work with no API key and send no Authorization header」で、4 つすべての公開ルートでヘッダーが存在しないことを検証
API キーがエラーメッセージに漏れることはありません	test/thatmgmt.test.js の「never leaks the API key in error messages」：キーは [REDACTED] に置き換えられる
再試行可能な GET／429／5xx では再試行は正確に 1 回で、400 または再試行不可の 503 では行われません	test/thatmgmt.test.js：429 の後は fetch が 2 回呼び出され、400 および再試行不可と指定された 503 では 1 回呼び出される
承認ゲートは、見積もり ID がない場合、approved: true でない場合、ID が一致しない場合に拒否します	test/tools.test.js の承認ゲートのケース
無効なドメインはネットワーク呼び出しより前に拒否されます	test/tools.test.js の「callTool rejects an invalid domain before any network call」：fetch の呼び出しは 0 回
利用不可のドメインの見積もりでは、{available:false} だけを返すのではなく、その旨が明確に示されます	test/tools.test.js の見積もり整形のケース
移管のドライランでは authCodePresent を渡し、生の認証コードは渡しません	test/tools.test.js の「passes authCodePresent (never the raw code)」

クイックスタート

git clone https://github.com/thingscorp/thatmgmt-mcp.git && cd thatmgmt-mcp
npm install
node demo-agent-run.mjs   # real server over stdio, stub API, zero signup

デモでは、ネットワークもキーも使わず、実際のサーバーを tmgmt_health → 空き状況確認 → ロック済み見積もり → 登録準備の順に実行します。ライブモード（公開ツールのみ、読み取り専用）：node demo-agent-run.mjs --live。

インストール

npm から（クローン不要）：

npx -y @thatmgmt/mcp

ソースから（Node 18 以上）：

git clone https://github.com/thingscorp/thatmgmt-mcp.git thatmgmt-mcp
cd thatmgmt-mcp
npm install
npm test

MCP クライアントに追加します（Claude Code .mcp.json、Cursor、Replit）：

{
  "mcpServers": {
    "thatmgmt": {
      "command": "npx",
      "args": ["-y", "@thatmgmt/mcp"],
      "env": { "TMGMT_API_KEY": "your-thatmgmt-api-key" }
    }
  }
}

キーが必要なのはテナント向けツールのみです。公開読み取りツールはキーなしで動作します。

リリースは自動化されています。バージョンタグ（例：v0.2.2）をプッシュすると、Publish to npm ワークフロー（NPM_TOKEN シークレットを使って npm publish を実行）と、Publish to MCP Registry ワークフロー（server.json を検証し、GitHub OIDC 経由で io.github.thingscorp/thatmgmt-mcp を公開）が実行されます。タグは package.json と server.json の version に一致する必要があります。

使用方法

2 段階の購入フローはすべてのツールの説明に記載されているため、エージェントはまず人間に価格を提示します。

1. 見積もり。 domains_get_quote を呼び出します。確定価格として、wholesaleCents、内訳が表示された 1％の手数料（platformCutCents、platformCutBasisPoints）、および totalCents が返されます。キーは不要です。この内容を人間に提示してください。
2. 計画。 domains_prepare_registration を呼び出します（TMGMT_API_KEY が必要です）。安全性を確認済みの計画が返されます。処理が実行されることはありません。

見積もりには、卸売価格、一律 1％のプラットフォーム手数料、合計金額が含まれます。サブスクリプションや料金プランはありません。モックのテストフィクスチャに基づく形式は、wholesaleCents: 1299、platformCutCents: 13、platformCutBasisPoints: 100、totalCents: 1312 です。

このサーバーでできないこと

ThatMgmt API には実行用エンドポイントがありません。購入、更新、移管、DNS 変更が API によって実行されることはありません。API が返すのは、検証済みの計画と事前確認の結果です。そのため、このサーバーでドメインの登録、更新、移管を行うことはできず、実行したと主張することもありません。src/approval.js には、将来の実行ツールで使用する承認ゲートが用意されています（見積もり ID を返し、明示的な approved: true フラグを渡す必要があり、そうでなければ呼び出しは拒否されます）。実行用ルートが追加されたときに備え、安全設計を整えておくため、このゲートは現時点で実装・テスト済みです。

現在のリリース：0.2.2（読み取り専用の公開ツールと検証済みの計画）。実行ツールは 0.3.0 リリースでの提供を予定しています。

設定

環境変数のみを使用します。フラグや設定ファイルはありません。

変数	必須	デフォルト	説明
TMGMT_API_KEY	テナントツールでのみ必要	—	Bearer トークンとして送信されるテナント API キーです。ログには記録されず、エラーからは伏せ字にされます。
TMGMT_BASE_URL	いいえ	https://api.thatmgmt.com	API のベース URL を上書きします。
TMGMT_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト（ミリ秒）です。

一時的な障害（ネットワークエラー、タイムアウト、429、再試行可能な 5xx）が発生した場合、副作用のない呼び出しは 1 回再試行されます。金銭が動く可能性のある処理が再試行されることはありません。

API リファレンス

サーバーが MCP stdio 経由で公開する 13 個のツールです。src/tools.js で定義されているとおりで、各ツールは公開中の OpenAPI 仕様にある実際のルートに対応しています。架空のエンドポイントはありません。

ツール	説明	API ルート	キーが必要
tmgmt_health	稼働状態の確認	GET /health/live	いいえ
tmgmt_capabilities	認証不要の公開機能を確認	GET /v1/public/capabilities	いいえ
domains_check_availability	ドメインが利用可能か確認	GET /v1/public/availability	いいえ
domains_get_quote	確定価格の見積もり：卸売価格＋内訳が表示された 1％の手数料＋合計金額（ステップ 1）	GET /v1/public/quote	いいえ
domains_suggest	代替名を提案	GET /v1/domains/suggestions	はい
domains_prepare_registration	安全性を確認済みの計画。処理は実行されません（ステップ 2）	GET /v1/domains/prepare-registration	はい
domains_list	ポートフォリオのドメイン一覧を取得	GET /v1/domains	はい
domains_dns	ドメインの DNS レコードを確認	GET /v1/domains/{resourceId}/dns	はい
portfolio_health	ポートフォリオの健全性の概要	GET /v1/portfolio/health	はい
portfolio_renewal_risk	更新リスクの概要	GET /v1/portfolio/renewal-risk	はい
portfolio_exceptions	優先順位付きの例外キュー	GET /v1/portfolio/exceptions	はい
orders_dry_run	価格の内訳を含む注文の完全な計画。金銭は動きません	POST /v1/orders/dry-run	はい
offerings	提供サービスの対応状況一覧	GET /v1/offerings	はい

公開ツールは Authorization ヘッダーを送信せず、キーを要求することもありません。テナントツールは、キーがない場合に 401 相当の拒否を返します。サーバーは TMGMT_API_KEY を設定するよう案内します。

エージェント向け

skills/thatmgmt/SKILL.md はこのサーバー用のエージェントスキルです。使用するタイミング、ツール一覧、2 段階の購入フローが記載されています。すぐに使い始めるには、エージェントにこのファイルを参照させてください。

コントリビューション

CONTRIBUTING.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。