エージェント向け UnlimitedTTS

AIエージェント向けの、非カストディアルで見積もり優先のテキスト読み上げ:

• @unlimitedtts/core は、ライブの x402 チャレンジを検証し、支出ポリシーを適用し、サニタイズ済みレシートを永続化し、プライベートな MP3 アーティファクトを書き込みます。

• @unlimitedtts/mcp は、stdio 上で tts_list_voices、tts_quote、および取り消し不能な tts_synthesize ツールを公開します。

• @unlimitedtts/openclaw は、MCP サーバーと unlimitedtts エージェントスキルをバンドルします。

• skills/unlimitedtts は、MCP ガイド付きおよび直接ウォレット対応の HTTP ワークフローをサポートします。

実装された v1 パスは外部署名モードです。別のウォレットツールが x402 v2 の PAYMENT-SIGNATURE を作成します。このコードはシードフレーズや秘密鍵を受け入れることはありません。

インストールとビルド

Node.js 20 以降と pnpm が必要です。

pnpm install --frozen-lockfile
pnpm check

このチェックアウトからローカルサーバーを実行します:

pnpm --filter @unlimitedtts/mcp build
node packages/mcp/dist/cli.js

npm 公開後の汎用 MCP 設定:

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/mcp@0.1.0"],
      "env": {
        "UNLIMITEDTTS_MAX_USDC_PER_CALL": "0.10",
        "UNLIMITEDTTS_ROLLING_24H_USDC": "1.00",
        "UNLIMITEDTTS_OUTPUT_DIRECTORY": "/absolute/approved/output"
      }
    }
  }
}

OpenClaw ローカル開発:

pnpm --filter @unlimitedtts/openclaw build
openclaw plugins install -l ./packages/openclaw
openclaw plugins enable unlimitedtts
openclaw gateway restart
openclaw plugins inspect unlimitedtts --runtime --json
openclaw plugins doctor

Related MCP server: mcp-ai-voice

支払いフロー

1. tts_list_voices は /docs と /tts/voices を取得し、結果を5分間キャッシュします。

2. tts_quote は支払いなしで正確な合成ボディを /x402/tts に送信し、返された PAYMENT-REQUIRED を検証してローカルポリシーを適用し、ローリング予算を確保して、短期間有効な HMAC トークンを返します。

3. ウォレットは返された selectedRequirement のみに署名します。

4. tts_synthesize は、トークン、変更されていないボディハッシュ、完全な x402 v2 accepted エントリ、正確な EVM 受取人と金額を検証し、その後、支払いを伴うリトライを1回送信します。

5. 成功した呼び出しには、audio/mpeg と PAYMENT-RESPONSE の両方が必要です。予算を確定し、サニタイズ済みレシートを書き込み、MP3 をモード 0600 でアトミックに保存し、構造化メタデータと MCP オーディオ/リソースコンテンツを返します。

PAYMENT_OUTCOME_UNKNOWN は、その見積もりをローカル台帳内で恒久的に隔離します。サーバーが2回目の支払いを自動的に送信または承認することはありません。

設定

受取人のローテーションは、信頼できる設定を通じてリリースされる必要があります。サーバーは、信頼できないチャレンジから許可された受取人を知ることはありません。

デフォルトは本番環境のままで、Base メインネットに固定されています。ステージング検証の場合は、UNLIMITEDTTS_ENVIRONMENT=staging を設定してください。これにより、https://staging-api.unlimitedtts.com、Base Sepolia（eip155:84532）、およびステージング USDC が選択されます。環境が明示的に staging でない場合、コアはステージングのオリジン、ネットワーク、またはアセットを拒否します。

スコープ

このチェックアウトは、ポータブルなローカル MCP、外部ウォレットアダプター契約、エージェントスキル、OpenClaw パッケージ、テスト、およびレジストリメタデータを実装しています。ホスト型 Streamable HTTP、一時的な R2 ストレージ、プリペイドカード合成、および具体的な管理型自動署名者は、意図的に完了した v1 機能として宣伝されていません。

無人での自動署名またはホスト型サービスを有効にする前に、必須および推奨されるアップストリームの変更 を参照してください。