Easy Predict

easy-predict

エージェントファーストの予測・異常検知 API です。数値のリストを送信すると、次の予測値または異常値のリストを取得できます。x402 v2 のマイクロペイメントにより、呼び出しごとに支払います。Base 上で $0.01 USDC です。API キーもアカウントも不要です。

公開中：easy-predict.com

---

エンドポイント

メソッド	パス	料金	説明
POST	/timeseries	$0.01 USDC	数値系列の次の値を予測します
POST	/anomaly-detection	$0.01 USDC	z スコアで異常値を検知します
GET	/.well-known/x402	無料	x402 v2 リソースの検出
GET	/openapi.json	無料	OpenAPI 3.1 仕様
GET	/llms.txt	無料	人間／エージェントが読める API ドキュメント

POST /timeseries

curl https://easy-predict.com/timeseries \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <signed-x402-payload>" \
  -d '{"series": [1.0, 2.3, 4.1, 6.8, 9.2], "context": "monthly revenue USD"}'

レスポンス：

{
  "prediction": 12.1,
  "method": "linear",
  "holdout_errors": {"linear": 0.05, "log1p-linear": 0.31, "last-delta": 0.05, "mean": 3.5},
  "slope": 1.94,
  "intercept": 0.12
}

モデルの選択では、最後の点を保留し、linear、log1p-linear、last-delta、mean をその点に対して評価してから、最良のモデルを系列全体で再学習します。

POST /anomaly-detection

curl https://easy-predict.com/anomaly-detection \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <signed-x402-payload>" \
  -d '{"series": [1.0, 2.3, 4.1, 6.8, 99.0], "threshold": 2.0}'

レスポンス：

{
  "anomalies": [{"index": 4, "value": 99.0, "z_score": 2.14}],
  "method": "z-score",
  "mean": 15.12,
  "std": 39.18,
  "threshold": 2.0
}

どちらのエンドポイントも、レスポンスにそのまま含めて返す任意の "context" 文字列（最大 200 文字）を受け付けます。

---

x402 の決済フロー

決済ヘッダーを省略すると、決済条件一式を含む 402 が返されます。

{
  "x402Version": 2,
  "error": "Payment Required",
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0xc99b83818c8865340AC55C45554f377f41c68DBC",
    "maxTimeoutSeconds": 60
  }]
}

1. 402 レスポンスから accepts[0] を解析します
2. ウォレットで決済ペイロードに署名します
3. 署名済み JSON を Base64 エンコードし、PAYMENT-SIGNATURE: <encoded> を付けて再試行します
4. Cloudflare Worker が https://x402.org/facilitator を通じて検証し、オンチェーンで決済を確定します

決済額：Base メインネット上で 10000 原子単位 = $0.01 USDC（小数点以下 6 桁）です。

---

MCP サーバー（Claude Desktop、Cursor、Windsurf）

MCP サーバーはお使いのマシン上でローカルに実行されます。ウォレットの秘密鍵がデバイスの外に出ることはありません。x402 の決済にローカルで署名し、署名済みヘッダーのみを easy-predict.com に送信します。

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "easy-predict": {
      "command": "uvx",
      "args": ["easy-predict-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYOUR_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Claude に「この系列の次の値を予測してください：1.2、2.4、4.1、6.8」と尋ねると、ツールを呼び出し、ウォレットから自動的に $0.01 USDC を支払って予測値を返します。

Smithery に掲載されています。easy-predict を検索すると、ワンクリックでインストールできます。

---

エージェントとの統合（Python）

402 → 署名 → 再試行の一連の処理を自動で行う、動作する Claude エージェントです。

pip install anthropic requests eth-account
ANTHROPIC_API_KEY=sk-... WALLET_PRIVATE_KEY=0x... python examples/demo_agent.py

examples/demo_agent.py — Anthropic のツール使用機能を利用します。同じパターンは LangChain、LlamaIndex、CrewAI、AutoGen でも使用できます。

デモモード（ウォレット不要、ローカルサーバーを使用）：

cd timeseries && python app.py &
ANTHROPIC_API_KEY=sk-... python examples/demo_agent.py

---

アーキテクチャ

• Cloudflare Worker（src/index.ts）— エッジランタイム、レート制限、facilitator を通じた x402 の検証と決済確定
• Flask バックエンド（timeseries/app.py）— Python による予測ロジック、ローカル開発サーバー
• 静的アセット（public/）— スプラッシュページ、openapi.json、llms.txt

Worker が本番環境のすべてのトラフィックを処理します。Flask アプリはローカル開発用で、ポート 8000 で実行されます。

---

ローカル開発

pip install -r requirements.txt
cd timeseries && python app.py        # Flask on http://localhost:8000

ローカルの Flask サーバーでは、決済の有無のみを確認します。空でない PAYMENT-SIGNATURE ヘッダーであれば受け付けます。実際のウォレットを使わずにテストする場合に便利です。

Cloudflare Worker の場合：

npm install
npx wrangler dev                      # Worker on http://localhost:8787

---

リポジトリ構成

timeseries/app.py                        Flask backend (prediction + anomaly detection logic)
anomaly_detection/app.py                 Anomaly detection blueprint
src/index.ts                             Cloudflare Worker (edge runtime)
mcp_server/easy_predict_mcp/server.py   MCP server — runs locally, signs payments on device
mcp_server/pyproject.toml               PyPI package definition (easy-predict-mcp)
smithery.yaml                            Smithery registry config
public/
  index.html                             Splash page
  openapi.json                           OpenAPI 3.1 spec
  llms.txt                               Human/agent-readable docs
examples/
  demo_agent.py                          Claude agent integration demo with x402 payments
tests/                                   Test suite

---

設定

Flask バックエンドの環境変数（すべて任意）：

変数	デフォルト	説明
PAY_TO_ADDRESS	0xc99b...	受取人のウォレット
X402_ASSET	Base 上の USDC	ERC-20 アセットアドレス
X402_NETWORK	eip155:8453	チェーン ID
X402_MAX_AMOUNT	10000	原子単位（$0.01）
FACILITATOR_URL	https://x402.org/facilitator	x402 facilitator
PUBLIC_BASE_URL	https://easy-predict.com	402 レスポンス内のリソース URL に使うベース URL