cron402

cron402-mcp

cron402 用 MCP サーバーです。x402 を介して、Base 上で USDC による実行ごとの支払いで Webhook 呼び出しをスケジュールできます。アカウントも API キーも不要です。ウォレットが認証情報になります。

小型モデルが安全に操作できるように設計されています。スケジュールは平易な英語で記述でき、有料の呼び出しを行う前に各スケジュールを無料で検証でき、すべての応答にモデルが次に何をすべきかを示す明示的な next_step が含まれます。

料金： 1 回あたり $0.008 USDC · ネットワーク： Base mainnet（eip155:8453）

クイックスタート

export CRON402_PRIVATE_KEY=0x...   # fund with USDC on Base
npx -y cron402-mcp

任意の環境変数：

変数	デフォルト	説明
CRON402_PRIVATE_KEY	(有料ツールには必須)	エージェントウォレットの秘密鍵です。設定しなくてもサーバーは起動し、無料ツールを利用できます。
CRON402_NETWORK	eip155:8453	CAIP-2 ID です。Base Sepolia には eip155:84532 を使用します。
CRON402_API_URL	production Worker	API のベース URL を上書きします。
CRON402_STATE_DIR	~/.cron402	list_crons 用に作成したジョブ ID を保存する場所です。

MCP クライアントの設定

Cursor / Claude Desktop：

{
  "mcpServers": {
    "cron402": {
      "command": "npx",
      "args": ["-y", "cron402-mcp"],
      "env": {
        "CRON402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

OpenCode（opencode.json）：

{
  "mcp": {
    "cron402": {
      "type": "local",
      "command": ["npx", "-y", "cron402-mcp"],
      "environment": {
        "CRON402_PRIVATE_KEY": "0x..."
      },
      "enabled": true
    }
  }
}

ツール

ツール	料金	説明
cron402_guide	無料	手順、料金、ルールのすべてを説明します。モデルが最初に読むべきツールです。
check_wallet	無料	アドレス、ネットワーク、USDC/ETH 残高、および支払い可能な実行回数を確認します。
preview_schedule	無料	スケジュールを検証し、次の 5 回の実行時刻を UTC で一覧表示します。
create_cron	$0.008	スケジュールされた Webhook ジョブを作成します（1 回分の実行クレジットを含みます）。
topup_cron	$0.008–$0.80	1、10、または 100 回分の前払い実行クレジットを追加します。
get_cron	無料	ジョブのステータス、クレジット、直近 20 回の実行を確認します。
list_crons	無料	このマシンから作成したジョブと、その最新ステータスを一覧表示します。
pause_cron	無料	ジョブを一時停止します（EIP-712 署名）。
resume_cron	無料	一時停止中のジョブを再開します（クレジットが必要です）。
delete_cron	無料	ジョブを完全に削除します（EIP-712 署名）。

有料ツールは x402 による支払いを自動で処理します。管理ツールは秘密鍵を使ってローカルで署名します。

弱いモデル向けの設計

• 平易な英語でスケジュールを指定。 "every 15 minutes"、"every weekday at 9am"、 "every monday at 5pm"、"weekly" および生の cron 形式に対応しています。曖昧または 実行不可能な表現（"every 2 weeks"、"at teatime"）は、誤ったスケジュールを 黙って設定するのではなく、修正方法を示して明確にエラーになります。
• タイムゾーン。 timezone: "America/New_York" を指定すると、時刻が API に保存される UTC cron に変換され、応答には DST に関する注意事項が含まれます。
• 無料のドライラン。 preview_schedule で 1 セントも使う前に次の 5 回の実行時刻を確認でき、 create_cron はローカルで再検証するため、不正なスケジュールに料金がかかることはありません。
• 支出のガードレール。 有料ツールは説明に PAID と明記し、正確な金額を示します。また、すべての応答で モデルに同じツールを 2 回呼び出さないよう伝えます。
• 対処方法がわかるエラー。 残高不足、API に接続できない場合、自分が所有していないジョブ、 localhost の宛先は、いずれも { ok: false, error, next_step } として返されます。
• ジョブの記憶。 作成したジョブ ID は ~/.cron402/jobs.json に書き込まれるため、 list_crons で復元できます。API には一覧取得エンドポイントがありません。
• 鍵なしで起動。 CRON402_PRIVATE_KEY がない場合、起動に失敗するのではなく読み取り専用に なり、モデルは不足しているものを説明できます。

エージェントスキル

エージェントにワークフロー全体を教える、すぐに導入できるスキルはこちらです： skills/cron402/SKILL.md：

mkdir -p .claude/skills/cron402
curl -sL https://raw.githubusercontent.com/userdefault13/ai-cron-site/main/skills/cron402/SKILL.md \
  -o .claude/skills/cron402/SKILL.md

リンク

• インテグレーションのドキュメント
• OpenAPI 仕様
• エージェントスキルのファイル
• ソースコード
• MCP Registry

ライセンス

MIT