stillos-notary-mcp

stillos-notary-mcp

エージェント経済のための検証インフラです。エージェントが主張を提出すると、公証人は、モデルの出力ではなく実際の外部情報に照らして判定し、Ed25519 署名付きのハッシュチェーンで結果を返します。無料枠があり、アカウントもカードも不要です。

このパッケージのすべてのツール呼び出しは、HTTPS 経由で稼働中の公開公証サービス（stillosdigitalholdings.com/notary）を利用します。ローカル専用または内部専用のコードパスは存在せず、実行環境にかかわらず動作は同一です。

インストール

npx stillos-notary-mcp mcp

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

{
  "mcpServers": {
    "stillos-notary": { "command": "npx", "args": ["-y", "stillos-notary-mcp", "mcp"] }
  }
}

ツール

claim_verdict

主張とリゾルバーの仕様を提出します。CONFIRMED、REFUTED、またはERRORを返します。無理に推測することはありません。結果には署名が付与され、ハッシュチェーンに記録されます。

対応するリゾルバーの種類：github_pr、onchain_tx、url_json、http_status、kalshi_market。

stillos-notary-mcp claim "your-agent" "example.com returns 200" \
  '{"type":"http_status","url":"https://example.com","expect_code":200}'

verify_receipt

ハッシュを使って任意のレシートを独立して検証し、ハッシュチェーンが損なわれていないことと、署名が有効であることを確認します。

stillos-notary-mcp verify <receipt_hash>

file_dispute

判定レシートに対する、担保付きの異議申し立てを行います。異議申し立ての対象となった判定は、その判定を生成したものと同一のリゾルバー仕様に対して直ちに再解決されます。これは独立した再実行であり、再投票でも、人間による異議申し立ての審査キューでもありません。異議申し立てが認められると判定は覆され、公証人のオンチェーン正確性ボンド（$10 USDC、Base）に対するスラッシュ可能な支払いがキューに登録されます。異議申し立て期間は、元のレシートのタイムスタンプから48時間です。

有料ツールの支払い（1.3.0）

1.2.2 までは、このパッケージはペイウォールを 報告 するだけでした。有料ツールはすべて { payment_required: true } を返して呼び出しを終了していました。パッケージ内には、支払いを添付して再試行する方法がどこにもありませんでした。CLI は、存在しない仕組みを使って「支払いを添付して再試行」するよう案内していました。1.3.0 では、この機能を実装しました。

認証情報を指定すると、402を自動的に処理します。402を1回受け取り、支払いを1回行い、再試行を1回行った後、有料の結果が返されます。

const { callTool } = require('stillos-notary-mcp');

// 1. Preferred: your own payment-capable fetch. We never see a key.
const r = await callTool('screen_entity', { agent: 'me', entity: 'Acme Corp' },
                         { fetch: myX402Fetch });

// 2. Or a viem account / signer object.
await callTool('screen_entity', args, { account: myViemAccount });

// 3. Or, as a documented fallback, a raw key in the environment.
//    export STILLOS_NOTARY_WALLET_KEY=0x...
await callTool('screen_entity', args);

認証情報がない場合は、行き止まりではなく、実行可能な要件が表示されます。

{
  "ok": false, "paid": false, "code": "PAYMENT_REQUIRED",
  "payment": { "amount_usd": 0.001, "network": "base", "pay_to": "0x…", "scheme": "exact" },
  "remediation": "Pass a payment-capable fetch as opts.fetch, a viem account as opts.account, or set STILLOS_NOTARY_WALLET_KEY, then call again."
}

支払いを拒否するケース。 402は信頼できない入力です。クライアントは、想定していないネットワークやスキーム（base / exact のみ）に対する署名を行いません。payTo または金額が欠けている不正な要件への支払いも行わず、呼び出しごとの上限（デフォルトは $1.50。変更するには STILLOS_NOTARY_MAX_USD または opts.maxUsd を指定）を超える支払いも行いません。再試行は最大1回です。2回目の402はバックオフループに入らず、即時停止します。そのため、拒否された支払いに再署名して二重支払いが発生することはありません。認証情報を指定しなければ、支払いは一切行われません。キーを受け取ったり、ログに記録したり、永続化したり、エラーメッセージに含めたりすることはありません。

test/payment-continuation.test.cjs でテスト済みです（17ケース、ローカルモックを使用。実際の決済は行いません）。

有料：x402経由で $1.00 USDC（Base）。無料枠はありません。 x402の支払いを添付せずに呼び出すと、判定ではなく、支払い要件（価格、payTo、アセット）が返されます。このパッケージはウォレットを保持せず、それ自体で支払いを実行しません。その機能は呼び出し元のエージェントが使用するクライアントが担います。

stillos-notary-mcp dispute "your-agent" <receipt_hash>

screen_entity

OFAC SDN 制裁対象者の名前を照合します。鮮度を示す source_as_of タイムスタンプ付きで、Ed25519 署名が付与されます。

1エージェントあたり1日5回まで無料。それ以降はx402経由で $0.001 USDC（Base）。

stillos-notary-mcp screen "your-agent" "Acme Corp"

distress_score

単一の株式ティッカーを対象とする、貸借対照表に基づく企業財務危機ランキング機能です。最新のSEC XBRL提出書類からAltman Zスコアを算出します。実際のChapter 11申請178件と日付を一致させた対照群71件を用いたホールドアウト評価で、AUCは0.769です。ベースレート2%での適合率は約3%です。これはレビューキューの順序付けに使うランキング指標であり、単一銘柄に対する警報ではありません。以前の「感度71%／特異度100%」という主張（n=14）は撤回されました。Ed25519 署名が付与されます。

1エージェントあたり1日3回まで無料。それ以降はx402経由で $0.15 USDC（Base）。

stillos-notary-mcp distress "your-agent" AAPL

理由

ほとんどの検証では、あるモデルが別のモデルの出力をチェックしています。独立性が確保されていないため、同じ失敗モードが生じます。このアーキテクチャでは、どちらの当事者も管理していない情報源に照らしてすべての主張を確定し、結果の方向にかかわらず署名し、確認済みと反証済みの判定を同じ台帳に公開します。フェイルクローズ方式のため、解決できない主張には ERROR を返し、もっともらしい推測は返しません。

最新のドキュメント：https://stillosdigitalholdings.com/notary/docs