cron402

本地服务

agentcron.site开发工具02 天前更新

代码仓库访问官网

关于 cron402

cron402 是一款 MCP 服务，用于安排定时 Webhook 调用，并在 Base 上以 USDC 按次付费。它支持自然语言描述计划、付费前免费验证，并在响应中给出明确的后续操作指引。

主要功能

01创建和管理定时 Webhook 任务
02验证计划并预览五次运行时间
03在 Base 上以 USDC 按次付费
04检查钱包余额和任务执行记录
05返回可执行的错误说明和后续步骤

适用场景

01安排周期性 Webhook 调用
02创建付费任务前验证执行时间
03监控预付次数和任务状态

MCP 相关

MCP 服务提供十种工具，用于预览计划、创建和管理任务、检查钱包及查询状态。付费操作通过 x402 支付，钱包密钥用于付款和本地签名。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "userdefault13-cron402": {
      "command": "npx",
      "args": [
        "-y",
        "cron402-mcp"
      ],
      "env": {
        "CRON402_PRIVATE_KEY": "<CRON402_PRIVATE_KEY>",
        "CRON402_NETWORK": "<CRON402_NETWORK>",
        "CRON402_API_URL": "<CRON402_API_URL>",
        "CRON402_STATE_DIR": "<CRON402_STATE_DIR>"
      }
    }
  }
}

启动命令npx -y cron402-mcp

需要配置的环境变量

CRON402_PRIVATE_KEY密钥Agent wallet private key (0x…). Fund with USDC on Base mainnet or Sepolia. Without it the server starts read-only: the free tools still work.

CRON402_NETWORKCAIP-2 network id. Default eip155:8453 (Base mainnet); use eip155:84532 for Sepolia.

CRON402_API_URLcron402 API base URL. Defaults to the production Worker.

CRON402_STATE_DIRDirectory where created job ids are remembered so list_crons can recover them. Defaults to ~/.cron402.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcron402-mcp1.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

cron402-mcp

cron402 的 MCP 服务——通过 x402 在 Base 上安排 Webhook 调用，并按次以 USDC 付费。无需账户或 API 密钥；你的钱包就是凭证。

专为小型模型安全驱动而构建：可以用通俗英语编写计划任务，每个计划任务都可以在付费调用前免费验证，而且每个响应都会附带明确的 next_step，告诉模型接下来该做什么。

价格： 每次运行 $0.008 USDC · 网络： Base 主网（eip155:8453）

快速开始

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

可选环境变量：

变量	默认值	描述
`CRON402_PRIVATE_KEY`	（付费工具必需）	Agent 钱包私钥。没有此密钥，服务仍会启动，免费工具也可以使用。
`CRON402_NETWORK`	`eip155:8453`	CAIP-2 ID；Base Sepolia 使用 `eip155:84532`
`CRON402_API_URL`	生产环境 Worker	覆盖 API 基础 URL
`CRON402_STATE_DIR`	`~/.cron402`	记录已创建任务 ID 的位置，供 `list_crons` 使用

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 表达式，响应中也会说明夏令时注意事项。
免费试运行。 preview_schedule 会在花费一分钱之前显示接下来 5 次触发时间；create_cron 也会在本地重新验证，确保错误的计划任务不会产生费用。
资金保护措施。 付费工具的描述中会注明 PAID，并列出确切金额；每个响应都会提醒模型不要重复调用。
可执行的错误信息。 资金不足、API 无法访问、任务不属于当前用户或目标为 localhost 时，都会返回 { ok: false, error, next_step }。
任务记忆。 已创建的任务 ID 会写入 ~/.cron402/jobs.json，以便 list_crons 找回这些任务——API 没有列表端点。
无需密钥即可启动。 缺少 CRON402_PRIVATE_KEY 时，服务会降级为只读模式，而不是启动失败，这样模型仍能说明缺少什么。

Agent 技能

教会 Agent 整套工作流程的即插即用技能位于 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