Softbot Studio agent tools

softbot-mcp

Softbot Studio の従量課金型エージェントツール向け MCP サーバーです。各呼び出しの料金は、x402 を通じて Solana メインネット上の USDC で、ご自身のウォレットから直接支払います。アカウントや API キーは不要で、失敗した呼び出しは無料です。

ツール	機能	価格（USDC）
read_url	ページを整形済みの Markdown とメタデータに変換	0.003
extract_structured	テーブル、JSON-LD、連絡先、リンク、CSS セレクターで指定したフィールドを抽出	0.004
check_solana_token	トークンの安全性判定（安全／注意／回避）	0.01
check_email	メールの配信可能性、使い捨てアドレス、誤記をチェック	0.002
check_domain	メールドメインをチェック（MX、SPF/DMARC/DKIM、経過年数）	0.002
check_wallet	Solana ウォレットのプロフィールと OFAC 照合	0.005
check_website	ウェブサイトの信頼性、フィッシング、類似サイトをチェック	0.003
screenshot_url	ページのスクリーンショット（MCP 画像として返却）	0.01
page_to_pdf	ページを A4 PDF に変換（埋め込みリソース）	0.01
softbot_status	セッションの支出額、予算、ウォレット（無料）	0

すべての有料ツールで dry_run: true を指定すると、支払いを行わずに価格とエンドポイントを返します。

無料トライアル

各ツールの最初の 3 回の呼び出しは、ウォレットごとに無料です。サーバーは x402 の sign-in-with-challenge にお使いのキーで自動的に署名します（署名のみで、資金は移動しません）。トライアルを使い切ると、通常どおり支払いが行われます。結果には free_trial と trial_remaining が表示されます。常に支払いを行うには、SOFTBOT_NO_TRIAL=1 を設定してください。

設定（環境変数）

• SOLANA_PRIVATE_KEY（有料の呼び出しに必須）は、少額の USDC を保有するウォレットのキーペアです（ネットワーク手数料は facilitator が支払うため、SOL は不要です）。base58、または solana-keygen が出力する JSON バイト配列を指定できます。残高の少ない専用ウォレットを使用してください。
• MAX_SPEND_USDC はセッションごとの予算です。デフォルトは 0.25 で、上限を超える呼び出しは拒否されます。
• SOFTBOT_DRY_RUN=1 を設定すると、すべてのツールが価格のみを表示するモードになります。
• SOLANA_RPC_URL は任意で、デフォルトでは公開 mainnet RPC が使用されます。

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "softbot": {
      "command": "npx",
      "args": ["-y", "softbot-mcp"],
      "env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）:

{
  "mcpServers": {
    "softbot": {
      "command": "npx",
      "args": ["-y", "softbot-mcp"],
      "env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
    }
  }
}

安全性

• キーは x402 の USDC 送金への署名にのみローカルで使用され、ログに記録されたり、外部に送信されたりすることはありません。
• サーバーが提示価格を超える金額、または USDC 以外の資産を要求した場合、クライアントは支払いを拒否します。
• サーバープロセスを再起動すると、予算はリセットされます。

開発

npm install && npm run build
node test/smoke.mjs          # list tools + dry run each
SOLANA_PRIVATE_KEY=... node test/smoke.mjs paid   # one $0.002 check_domain call

MIT ライセンスです。