@ukiyocompute/mcp 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ukiyo Compute LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# Ukiyo MCP 0.2.1
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Node.js 24+, local stdio only: `npm install -g @ukiyocompute/mcp@0.2.1`, then
+`ukiyo-mcp`. Staged for owner-approved publication, not published by this build.
+
+Read `https://pay.u-kiyo.ai/api/v1/terms` and its linked document. Call
+`signup_account` with explicit `acceptTerms: true`, `acceptedTermsVersion`,
+`maxPerRentalMinor`, `budgetLimitMinor`, `maxConcurrentDeployments`.
+The scoped token is stored securely locally, never returned. Alternatively use
+UKIYO_API_TOKEN from a headless `ukiyo signup`. Telegram is optional for owners.
+
+Journey: signup_account → get_account_balance → topup_account_with_wallet →
+list_compute_offers → rent_gpu → get_rental_status until ACTIVE →
+get_deployment_credentials → run your SSH workload → terminate_deployment.
+Credentials contain a secret: never expose them to shared transcripts. Confirm
+termination with the user. For secret-safe execution prefer `ukiyo exec`.
+
+Wallet funding requires UKIYO_MACHINE_CONFIG with explicit caps and a private
+wallet file. Reuse idempotencyKey and amount. Pending means do not pay again;
+call get_topup_status. topup_account_with_card returns a hosted funding link.
+For an unpaid challenge only, use `ukiyo topup rails --amount 5 --plain
+--idempotency-key <key> --json` before the funded acceptance rental.
+
+rent_gpu accepts gpuModel, optional gpuCount and maxHourlyPriceMinor; Ukiyo picks
+the machine. It spends account credit. Reuse the same idempotencyKey for retries,
+retain rentalId/deploymentId, and never rent again because a status poll timed out.
+Legacy prepaid accounts also supply budgetMinor. No separate MCP business logic.
+
+Tools: signup_account, get_account_balance, list_compute_offers, rent_gpu,
+get_rental_status, list_deployments, get_deployment_status,
+get_deployment_credentials, terminate_deployment, topup_account_with_card,
+topup_account_with_wallet, get_topup_status, purchase_compute_with_wallet,
+machine_purchase_status, machine_purchase_terminate.
+
+Image interpreter: /venv/main/bin/python. cuDNN ships in its torch wheel, not as
+a system package. python3 is not the image interpreter.