halowerk-mcp

halowerk-mcp

MCP ツールとして利用できる70種類の有料 API。アカウント登録、ログイン、サブスクリプションは不要です。数ドル入った使い捨てウォレットがあれば十分です。

署名を行う前に、支出額には上限が設定されます。

変数	デフォルト	機能
HALOWERK_MAX_PREIS_USDC	0.05	1回の呼び出しあたりの上限です。これを超えるサービスは、黙って購入されるのではなく拒否されます。
HALOWERK_BUDGET_USDC	1.00	1セッションあたりの上限です。この額に達すると、サーバーはそれ以降の呼び出しを拒否します。
HALOWERK_TROCKEN	off	ドライランです。価格と呼び出しの計画を返し、支払いは行いません。

有料の回答にはすべて、bezahlt_usdc、budget_rest_usdc、トランザクションハッシュが含まれるため、モデルとあなたの両方が同じ数値を確認できます。

---

ウォレットなしで試す

ウォレットなしで無料で使えるツールが2つあります。halowerk_katalog はすべてのサービスとその価格を一覧表示し、halowerk_preis は予定している呼び出しの費用を知らせます。インストールしてサービスを確認し、利用するかどうかは後で決められます。

{
  "mcpServers": {
    "halowerk": { "command": "npx", "args": ["-y", "halowerk-mcp"] }
  }
}

これは、Claude Desktop の設定（claude_desktop_config.json）、Cursor の mcp.json、または Cline の MCP 設定に記述します。

呼び出しの支払い

{
  "mcpServers": {
    "halowerk": {
      "command": "npx",
      "args": ["-y", "halowerk-mcp"],
      "env": {
        "HALOWERK_PRIVATE_KEY": "0x…",
        "HALOWERK_MAX_PREIS_USDC": "0.05",
        "HALOWERK_BUDGET_USDC": "1.00"
      }
    }
  }
}

支払いには、Base 上の USDC を使う x402 を使用します。アカウント登録、カード、請求書は不要です。呼び出しには正確な金額に対する署名済みの認証が含まれ、サービスが決済します。

使い捨てウォレットを使う

新しいウォレットを作成し、そこに数ドル分の USDC を入れて、ほかの用途には使わないでください。

このパッケージを信用できないからではありません。まだ信用する理由がないからです。MCP 設定に入れたキーには、モデル駆動のプロセスがアクセスできます。それを安全にする方法は、コードを信頼することではなく、被害を小さく抑えることです。ウォレットに3ドルしか入っていなければ、最悪の場合でも失うのは3ドルです。

ガス代用の ETH は不要です。支払いには EIP-3009 の transferWithAuthorization を使うため、第三者がトランザクションを送信します。ETH の残高がちょうど0であっても、正常な状態です。

コードによるキーの取り扱い

• HALOWERK_PRIVATE_KEY からのみ読み込みます。ファイル、引数、プロンプトから読み込むことはありません。
• ログに記録されることも、エラーメッセージに入ることも、回答として返されることもありません。途中まで表示されることもありません。この点を確認するテストがあります。npm run pruefe は出力全体からキーの先頭8文字を検索し、見つかった場合は失敗します。
• src/x402.ts は約300行で、キーを扱う唯一のファイルです。5分で読めるように書かれています。

資金の支払い先

サーバーが支払うのは、ビルド時にカタログへ組み込まれた10個のホストだけです。 リストはパッケージ内に固定されており、ファイル、環境変数、ツール引数によって追加することはできません。

これが設計全体の要点です。任意の URL を受け取って支払うツールは、支払い先が空欄の支払い指示と同じです。ウェブページ、PDF、メールを読んだモデルは、そのテキストによって、攻撃者のアドレスを指定してそのようなツールを呼び出すよう指示される可能性があります。そのため、次の対策を行っています。

• 接続先ホストは、組み込みリストと完全に一致しなければなりません。サフィックスによる照合は行いません。halowerk.com.attacker.example はどの endsWith チェックにも通りますが、別のホストです。
• https のみを許可します。リダイレクトは追跡しません。外部ホストへの301リダイレクトは、不便ではなく攻撃です。
• IP アドレス、localhost、プライベートアドレス範囲は許可しません。
• 違反があった場合は、その理由を示して拒否します。署名を行う前に拒否します。

halowerk_rufe_auf が受け取るのは、カタログにあるツール名であり、URL ではありません。

モード

ツールが70個あると、特にほかの MCP サーバーも接続している場合、ツール選択が誰にとっても使いにくくなります。そのため、次のモードを用意しています。

HALOWERK_MODUS	ツール	用途
hero（デフォルト）	12個のサービス＋無料ツール2個	日常的な利用
gateway	メタツール3個＋無料ツール2個	コンテキストを最小限に抑えたい場合。追加の往復が2回必要です
all	70個のサービス＋無料ツール2個	使いたいものが決まっている場合

gateway モードでは、halowerk_suche が説明からサービスを検索し、halowerk_beschreibe が入力スキーマを返し、halowerk_rufe_auf が実行します。

なぜこの12個なのか

基準は1つだけです。同じタスクで、エージェントは何を複数回必要とするのか？ セッションごとに1回だけ使うツールなら検索できますが、10回使うものはツールボックスに入れておくべきです。さらに、この12個はすべてテキスト入力・テキスト出力です。チャットウィンドウで使う場合、最初にファイルのアップロードが必要なツールは、ほとんど使いものになりません。

ツール	繰り返し使う理由
cost_estimate	モデルを呼び出すたびに必要
output_validate	モデルの回答ごとに必要
tool_arg_validate	コストの高い呼び出しや取り消せない呼び出しの前に必要
state_store	長いタスクの各ステップで必要
cve_check	依存関係のリストごとに必要で、複数回確認する
license_check	同じ監査で、パッケージセットごとに必要
tls_chain	インフラストラクチャの確認で、ホストごとに必要
jwt_verify	認証のデバッグ時に、トークンごとに必要
webhook_signature	インテグレーションのデバッグ時に、Webhook ごとに必要
doc_diff	レビューで、ファイルのペアごとに必要
web_archive	調査タスクで、URL ごとに必要
invoice_audit	一括処理で、請求書ごとに必要

段階制料金 — 予算を設定する前にお読みください

サービスによっては、単位ごとに課金されます。たとえば、音声の分数、1000文字ごと、サンプルポイントごとです。その場合、price_usdc は最低額にすぎません。

そのため、予算チェックでは上限額である max_usdc を使用します。最低額を基準にすると、0.006 で承認して 0.25 を支払うことになります。エンドポイントは長さに応じて課金されますが、その長さはカタログではなくリクエスト本文に含まれているためです。

サービスに上限額がまったくない場合、その料金は無制限として扱われ、unbegrenzt_erlauben: true が指定されていない限り呼び出されません。不明な金額を基準に確認する予算は、予算とは言えません。

このパッケージの対象外

• ウォレットマネージャーではありません。支払いに署名しますが、ほかの場所へ資金を移動することはありません。
• キーを作成したり保存したりしません。
• ホームに接続しません。外部へのリクエストは、カタログに記載された10個のホストにのみ送信されます。
• カタログは稼働中のサービスから生成され、パッケージに同梱されています。実行時には取得されないため、サーバーが侵害されても呼び出しの合間に許可リストへ自分自身を追加することはできません。

開発

npm run katalog   # regenerate katalog.json from the live services
npm run build     # compile TypeScript
npm run pruefe    # modes, spending brakes, attack tests, key-leak test

katalog.json は生成されるファイルです。手作業で編集しないでください。再生成して再公開しないと、サービスが請求しない料金をパッケージが約束することになります。

ライセンス

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