habitscore

habitscore-mcp

Habitscore の MCP サーバーです。完了履歴が繰り返し記録されるあらゆるデータを分析します。

2 種類のツール群を、1 つのエンジンで提供します。

• 運用上の信頼性 — 繰り返し実行されるタスク、ジョブ、パイプライン、スケジュール済みワークフローをスコアリングします。成功率、連続記録の回復、失敗リスク、遅延傾向の警告、優先度順の改善策を提示します。
• 行動分析 — 習慣やルーティンのデータにも、同じスコアリングを適用します。遵守状況、一貫性、勢い、失敗リスク、次善のアクション、複数週のプランを提示します。

x402 による従量課金です。Base 上の USDC を使用し、アカウント、API キー、サブスクリプションは不要です。1 回あたり $0.03 からご利用いただけます。

x402 クライアントの実際に動作するサンプルを含むチュートリアル：https://mydev-tools.tech/agents/reliability/

この仕組みを採用している理由

このサーバーは、お使いのマシン上で、お使いのウォレットを使って動作します。支払いへの署名はローカルで行われ、秘密鍵がプロセスの外に出ることはありません。こちらで資産を預かることはなく、作成が必要なアカウントもありません。これは HTTP API が掲げる約束と同じです。

ウォレットを設定していなくても、すべてのツールを見積もり専用モードで利用できます。エラーを返す代わりに価格と支払い条件を返すため、資金を入金する前に呼び出しの費用を確認できます。

インストール

// Claude Desktop: claude_desktop_config.json
// Cursor:         ~/.cursor/mcp.json
{
  "mcpServers": {
    "habitscore": {
      "command": "npx",
      "args": ["-y", "habitscore-mcp"],
      "env": {
        "HABITSCORE_PRIVATE_KEY": "0x…",
        "HABITSCORE_MAX_SPEND_USD": "0.25"
      }
    }
  }
}

HABITSCORE_PRIVATE_KEY を省略すると、見積もり専用モードで起動します。

ウォレット

使う予定の金額だけを保有する専用ウォレットを使用してください。 Base 上の少額の USDC で入金してください（コントラクト 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。ETH は不要です。EIP-3009 では、認可にオフチェーンで署名し、ファシリテーターがトランザクションを送信してガス代を支払います。

HABITSCORE_MAX_SPEND_USD は、1 回のツール呼び出しで使用できる上限を設定します。この上限は、何かに署名する前にサーバーが実際に見積もった価格と照合されます。有料ツールを呼び出すエージェントのループが再試行を繰り返すと、支出に上限がなくなる可能性があります。支払うのはユーザーであるため、許可した金額を超える見積もりを返すサーバーは、支払いを行わず拒否します。

ツール

ツール	価格	返される内容
analyze_reliability	$0.08	タスクごとの信頼性スコアと評価、失敗リスク、遅延傾向の警告、優先度順に並べた改善策
analyze_behaviour	$0.05	遵守状況と一貫性のスコア、連続記録の勢い、失敗リスクのフラグ、注目点、注意点、推奨事項
recommend_next_actions	$0.03	習慣ごとの次善のアクションを、根拠と優先度とともに順位付けして提示
extract_insights	$0.05	パターン、相関関係、リスクシグナルの要約
build_habit_plan	$0.10	1 つの習慣に対する複数週のプラン：週ごとの目標と日付付きのマイルストーン

価格は習慣ごとではなく、呼び出しごとです。 analyze_behaviour は同じ $0.05 で最大 25 件の習慣を受け付けるため、まとめて処理するのが最もお得です。

入力

信頼性：

{
  "system": "billing-pipeline",
  "tasks": [
    {
      "name": "nightly-etl",
      "success_rate": 0.83,
      "current_streak": 0,
      "best_streak": 52,
      "runs": 210,
      "latency_trend": "rising",
      "p95_latency_ms": 38000,
      "cadence": "daily",
      "critical": true
    }
  ]
}

name、success_rate（0～1）、current_streak、best_streak は必須です。latency_trend: "rising" は劣化を示すシグナルです。行動分析ツールでは低下傾向が警告となるため、極性が逆である点に注意してください。

行動分析：

{
  "habits": [
    {
      "name": "Morning run",
      "completion_rate": 0.72,
      "current_streak": 9,
      "best_streak": 21,
      "average_mood": 7.4,
      "energy_trend": "rising"
    }
  ]
}

name、completion_rate（0～1）、current_streak、best_streak は必須です。average_mood、mood_correlation、energy_trend、risk_score は省略可能で、指定すると結果の精度が高まります。

「習慣」はこの分野で使われる用語ですが、この分析は完了履歴が記録されるあらゆる反復活動に適用できます。トレーニングの予定、服薬の遵守、学習のルーティン、繰り返し行う運用タスクなどが対象です。

対応していないこと

このエンジンは決定論的で、CPU のみを使用します。入力された数値に対して、しきい値ルールと算術演算を適用します。同じ入力に対しては、常に同じ出力が返されます。

このエンジンは言語モデルではなく、分析結果をまとめる以上の文章を生成しません。また、データを保存しません。エージェント用エンドポイントはステートレスで、ユーザー識別子を受け付けず、保存された履歴を読み取ったり推測したりすることはできません。医療、心理、金融に関する助言を提供するものではありません。

環境

変数	デフォルト	用途
HABITSCORE_PRIVATE_KEY	—	支払いに署名するためのウォレットキーです。見積もり専用モードでは省略してください。
HABITSCORE_MAX_SPEND_USD	0.25	ツール呼び出しごとの上限です。署名の前に適用されます。
HABITSCORE_API_URL	https://api.mydev-tools.tech	API のオリジンです。
BASE_RPC_URL	https://mainnet.base.org	残高の読み取りと署名コンテキストに使用する Base RPC です。

支払いの確認

成功した有料呼び出しでは、決済トランザクションのハッシュがツールの出力に追加されます。 エクスプローラーで開くと、このサーバーの報告に依存せずに金額と受取人を確認できます。

リンク

• API：https://api.mydev-tools.tech
• 概要：https://mydev-tools.tech
• OpenAPI：https://api.mydev-tools.tech/openapi.json
• 機能：https://api.mydev-tools.tech/v1/capabilities
• 料金と利用量リベート：https://api.mydev-tools.tech/agent/v1/pricing

利用量リベート

確認済みの支出に応じてクレジットが還元されます。累計10ドルで5％、100ドルで10％、1,000ドルで15％となり、各ティアでレート制限も緩和されます。クレジットは獲得した応答に含めて返され、後続の呼び出しで X-Agent-Credit ヘッダーを使って引き換えられます。

MIT ライセンスです。