EQVPS の MCP サーバー(バージョン 1.9.1)には、顧客トークン向けに 47 のツールがあります。このページでは VPS を借りて運用する 23 ツールについて、各パラメータとその型・デフォルト値を説明し、最後にコピーして使える呼び出し手順を載せています。Endpoint:https://mcp.eqvps.com/mcp(Streamable HTTP)。初めての方は接続ガイドから始めてください。
最終確認:2026-10-20、MCP サーバー 1.9.1(tools/list)。
どのページが必要ですか? VPS 呼び出しのパラメータはこのページです。委任、サポート、サンドボックス、30 のリセラーツールを含む全ツールの一覧は完全なリストにあります。漏えいしたトークンで何ができるか、エージェントをどう制限するかは MCP guardrails で説明しています。
認証。 list_plans、get_order_limits、register_account、login は公開です。それ以外はすべて Authorization: Bearer <token> が必要です。同じ MCP セッション内では、register_account または login の後にトークンが記憶されます。
service_id は order_vps や list_vps から得られるサービスコードで、例は 68J67T5 です。数値の id も使えます。
アカウントとトークン
| ツール | 認証 | パラメーター | 内容 |
|---|---|---|---|
list_plans | public | — | 各プランの料金、スペック、起動できる OS イメージ。plans[] に月額と年額の plan_id が入っています。最初に呼び出します。 |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, デフォルト 365) | パスワードなしのアカウントを作成し、再利用できる Bearer token と token_expires_at を返します。呼び出しは一度だけ。二度目は空のアカウントがもう一つできます。 |
login | public | email, password, token_ttl_days? | 新しいトークンを返します。set_password の後でのみ使えます。 |
refresh_token | Bearer | expires_in_days? (1–1825) | 新しいトークンを発行し、現在のトークンを即座に無効にします。期限切れのトークンは更新できません。 |
set_password | Bearer | password (8 文字以上、英字と数字) | トークンを失くしたときの予備として、メールとパスワードによる login を有効にします。一度だけ。二度目の呼び出しは 409 を返します。 |
whoami | Bearer | — | アカウントの id、名前、メール。トークンの確認に使います。 |
残高と注文
| ツール | 認証 | パラメーター | 内容 |
|---|---|---|---|
get_balance | Bearer | — | 前払い残高と通貨。order_vps はここから支払います。 |
topup_balance | Bearer | amount (USD) | 暗号資産によるチャージを作成し、checkout_url を返します。支払いがオンチェーンで確認されると残高に反映されます。未払いのチャージは同時に一つまで。 |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | VPS を注文し、残高が足りれば残高から支払います。足りなければ請求書を返します。location を省略するとこちらで選びます。Windows プランは ssh_key を無視します。quantity を 2〜50 にすると請求書1通でその台数の個別サーバーになります。再試行時は同じ idempotency_key を送ってください。 |
get_order_limits | public | product, period?, plan_id?, location?, addons? | 1注文あたりの上限(max_quantity = 50、入力ミス防止)と利用できる追加サービス、価格。 |
pay_invoice | Bearer | invoice_id | 未払いの請求書の checkout_url を返します。支払いが済むと VPS が作成されます。 |
VPS の運用
| ツール | 認証 | パラメーター | 内容 |
|---|---|---|---|
list_vps | Bearer | — | 稼働中、作成中、停止中のサービス。削除済みのものは表示されません。 |
get_vps_status | Bearer | service_id | 状態、スペック、現在の稼働状況とアクセス情報:ホスト、ポート、すぐ使える command(Linux は SSH、Windows は RDP)。reveal_password は起動後に一回限りの root パスワードを返します。password_pending: true なら 30〜60 秒後に再度呼び出してください。 |
reveal_password | Bearer | service_id | SSH 鍵なしの VPS の root パスワード。表示は一度だけ。起動中は password_pending: true なので、30〜60 秒後にもう一度呼び出します。 |
power_vps | Bearer | service_id, action (start | stop | reboot) | 電源操作。 |
set_hostname | Bearer | service_id, hostname | 稼働中のサーバー内でゲストエージェントを通じて反映されます。Windows では再起動後に有効になります(reboot_required: true)。サーバーが停止していると 409 agent_unavailable を返します。 |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, デフォルト hour) | CPU、メモリ、ネットワーク、ディスクの時系列。 |
プラン変更と解約
| ツール | 認証 | パラメーター | 内容 |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | この VPS がデータを保ったまま移れるプラン:より大きいプラン、NAT から専用 IPv4、専用から NAT。各オプションに prorated_topup、mode、capacity_now があります。ディスクは縮小できません。 |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | その場でプランを変更し、約1分の再起動が1回あります。日割りの差額は残高から引かれます(不足時は 402)。 |
cancel_service | Bearer | service_id, reason (3〜500 文字、必須), type? (end_of_period | immediate), confirm? | デフォルトは end_of_period:支払い済み期間の終わりまで稼働し、更新されません。immediate はサーバーを即座に破棄し、正確な hostname を入れた confirm が必要で。レスポンスには refund_amount フィールドが含まれます。 |
undo_cancel | Bearer | service_id | 予定済みの end_of_period 解約を取り消します。即時解約は取り消せません。 |
破壊的操作:confirm が必要
confirm には get_vps_status の正確な hostname か DELETE を指定します。呼び出す前に人間に確認してください。
| ツール | 認証 | パラメーター | 内容 |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | 新しい root パスワードは 10〜30 秒で稼働中のサーバーに反映され、古いパスワードは使えなくなります。新しいパスワードは reveal_passwordで一度だけ読み取ります。パスワードを失くしたとき用で、起動中のサーバーには使いません。 |
reinstall_vps | Bearer | service_id, os_id, confirm | ディスクを消去して os_id をインストールします。データはすべて失われます。バックグラウンドで実行されるので get_vps_status をポーリングしてください。 |
例:ゼロから稼働中のサーバーまで
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
エージェント向けのメモ
- 公開の 3 つを除くすべての呼び出しで
Authorization: Bearer <token>を送ってください。素の HTTP を使う場合はトークンをファイルに保存します。シェル変数は別々のコマンド間で保持されません。 - ポートを推測せず、アクセス情報は
get_vps_statusから読み取ってください。NAT プランは個別ポート、専用 IPv4 プランは Linux が 22、Windows が 3389 です。 - 新しいサーバーの起動には 1 分ほどかかります。
get_vps_statusのポーリングを続け、SSH がすぐ応答しないからといってreset_passwordを呼ばないでください。 topup_balanceとpay_invoiceは支払いリンクを返し、支払いは人間かウォレットが行います。Monero はダッシュボードでの別の手動チャージです:Monero での支払いを参照してください。
MCP を使わずに同じ操作をするには REST API ドキュメントを参照してください。
コメント
まだコメントはありません。最初になりましょう。