Base Token Facts

base-facts-mcp

Base 上で取引や送金を行う AI エージェント向けの MCP サーバーです。各ツールは Base Token Facts を呼び出し、x402 を通じて、 自分で管理する少額のウォレットから USDC で呼び出し料金を支払います。すべての回答は単一のブロックで読み取られ、そのブロックが明示されます。

Tool	Price	Answers
base_token_verdict	$0.01	トークンを購入する前に確認する、リスクレベル、スコア、フラグ（プロキシ、ミント、一時停止、ブラックリスト、所有者、DEX 流動性）。それぞれにオンチェーンの事実が付属します
base_token_sellcheck	$0.005	ハニーポットと税率のチェック：最も流動性の高いプールで少額の購入と直後の売却をシミュレートし、購入・売却時の税率と往復損失を返します
base_token_batch_screen	$0.03	1 回の呼び出しと 1 回の支払いで、最大 10 個のトークンに対して同じシミュレーションを実行します（トークンごとに、税率、往復損失、フラグを返します）
base_token_sellcheck_size	$0.01	取引サイズ（amountEth、0.001～10 ETH）で同じチェックを実行します。税率、往復損失、購入時の価格インパクトを返し、サイズがプールの吸収可能量を超える場合は流動性不足を警告します
base_token_facts	$0.005	ERC20 のメタデータ、所有者、プロキシと実装、バイトコード内の管理者セレクター
base_wallet_snapshot	$0.002	ETH と USDC の残高、ノンス、コントラクトかどうか
base_gas	$0.001	Base の手数料、優先手数料、ガス価格
base_tx_summary	$0.003	トランザクションのステータス、手数料、デコードされた ERC20 の送金
basename_resolve	$0.002	name.base.eth からアドレスへ、またはアドレスから検証済みのプライマリー Basename へ変換します
base_facts_budget	free	このセッションでの支出額

事実とヒューリスティックであり、金融アドバイスではありません。API ドキュメントとリアルタイムの収益カウンター： https://base-facts.yankii.fr および https://base-facts.yankii.fr/stats

セットアップ

1. 専用のウォレットを作成し、Base ネットワーク上で少額の USDC を入金します（USDC 1 枚で判定 100 回分です）。ETH は不要です。x402 のファシリテーターがガス代を支払います。メインのウォレットは絶対に使用しないでください。
2. 例として claude_desktop_config.json のように、MCP クライアントにサーバーを追加します：

{
  "mcpServers": {
    "base-facts": {
      "command": "npx",
      "args": ["-y", "base-facts-mcp"],
      "env": {
        "X402_PAYER_FILE": "/path/to/payer.json",
        "MAX_PRICE_USD": "0.03",
        "SESSION_BUDGET_USD": "1"
      }
    }
  }
}

payer.json の形式は { "privateKey": "0x..." } です。X402_PRIVATE_KEY も使用できます。どちらも指定しない場合、ファイルが存在すればサーバーは ~/.base-facts-mcp/payer.json を使用します。

command と args のみを渡すホスト（Preste）向けに、すべての設定をオプションとして指定することもできます： --payer-file <path>、--max-price <usd>、--budget <usd>、--api <url>。Preste の設定とスキルについては integrations/preste/ を参照してください。

支出の安全対策

• 各ツールには独自の上限（公表価格：ガスは 0.001、バッチは 0.03 など）もあります。ルートが公表価格を超える料金を要求した場合、MAX_PRICE_USD の設定にかかわらず拒否されます。
• 有料呼び出しの支払い署名後に回答を受け取れなかった場合、その金額はセッション予算に計上されます（支払いが確定している可能性があります）。その旨がツールから通知されるため、再試行する前にウォレットを確認してください。
• MAX_PRICE_USD（デフォルトは 0.03）：この金額を超える単一の支払いへの署名をクライアントが拒否します。
• SESSION_BUDGET_USD（デフォルトは 1）：上限に達すると、再起動するまでクライアントは署名を停止します。
• BASE_FACTS_PAY_TO（デフォルト：デフォルトの API を使用する場合は公式アドレス）：クライアントが署名する唯一の送金先です。カスタムの BASE_FACTS_URL を使用する場合は必須です。指定しないと署名は行われません。また、クライアントは Base の USDC（0x8335…2913）に対してのみ署名します。
• 署名されるのは Base（eip155:8453）上の USDC のみです。
• 呼び出しが拒否または失敗（4xx/5xx）した場合、決済はキャンセルされます。請求は発生せず、理由（例：USDC 不足）とともにツールから charged: false が返されます。
• 予算の計算を正確に保つため、有料呼び出しは一度に 1 件ずつ実行されます。

開発

npm test は空のウォレットを使い、実際のクライアントと同様に stdio 経由でサーバーを実行します。USDC は消費されません。