Base Token Facts

io.github.yankiifrv0.2.1更新於 Oct 6, 2026

Base token checks for agents: simulated buy and sell, taxes, honeypots. Pay per call in USDC (x402).

已驗證STDIO僅桌面Security & MonitoringFinance

概覽

AI 產生的概覽

讓助理在交易前檢查 Base 代幣：風險判定、蜜罐與稅費模擬、錢包與 Gas 資料，每次呼叫以 USDC 付費。

功能
它提供一組唯讀工具查詢 Base Token Facts 服務：base_token_verdict 回傳風險等級、評分與代理、增發、暫停、黑名單、擁有者、DEX 流動性等標記；base_token_sellcheck 在最深池上模擬小額買入並立即賣出，給出買入/賣出稅費與來回損失；base_token_facts 回傳 ERC20 中介資料、擁有者、代理與實作；base_wallet_snapshot、base_gas、base_tx_summary 與 basename_resolve 分別涵蓋餘額、費用、交易解碼與 Basename 解析。base_facts_budget 顯示本次工作階段已花費金額。每次付費呼叫透過 x402 從你控制的錢包以 USDC 結算，答案基於單一區塊讀取。
適用情境
當助理準備在 Base 上買入、賣出或轉移代幣，需要先取得鏈上事實並做蜜罐或稅費檢查時使用。它鎖定在 Base 上交易或移動資金的代理工作流程，而非一般區塊鏈瀏覽。
執行需求
以 stdio 在本機執行，通常透過 npx base-facts-mcp，因此需要 Node.js。需要一個專用的 Base 錢包並存入少量 USDC，透過 X402_PRIVATE_KEY 或付款方檔案提供（X402_PAYER_FILE，預設 ~/.base-facts-mcp/payer.json）。選用設定包括 MAX_PRICE_USD 與 SESSION_BUDGET_USD。需要連線至 Base Token Facts API 的網路；未宣告帳號或登入。
安裝前請注意
此伺服器會在 Base 上簽署真實的 USDC 付款，每次呼叫 0.001 至 0.01 美元，因此有資金的錢包存在風險；請使用專用錢包，切勿使用主錢包。X402_PRIVATE_KEY 與付款方檔案含有私鑰，必須妥善保護。MAX_PRICE_USD 與 SESSION_BUDGET_USD 限制單次與單工作階段支出，失敗的呼叫不會扣款。輸出為事實與啟發式判斷，不構成財務建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Base Token Facts，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

base-facts-mcp

An MCP server for AI agents that trade or move money on Base. Each tool calls Base Token Facts and pays for the call itself in USDC over x402, from a small wallet you control. Every answer is read at one block and says which.

ToolPriceAnswers
base_token_verdict$0.01Before buying a token: risk level, score and flags (proxy, mint, pause, blacklist, owner, DEX liquidity), each with its on-chain fact
base_token_sellcheck$0.005Honeypot and tax check: simulates a small buy and immediate sell on the deepest pool, returns buy/sell tax, round-trip loss
base_token_facts$0.005ERC20 metadata, owner, proxy and implementation, admin selectors in the bytecode
base_wallet_snapshot$0.002ETH and USDC balances, nonce, contract or not
base_gas$0.001Base fee, priority fee, gas price
base_tx_summary$0.003Status, fee and decoded ERC20 transfers of a transaction
basename_resolve$0.002name.base.eth to address, or address to its verified primary Basename
base_facts_budgetfreeWhat this session has spent

Facts and heuristics, not financial advice. API docs and live revenue counter: https://base-facts.yankii.fr and https://base-facts.yankii.fr/stats

Setup

  1. Make a dedicated wallet and put a little USDC on it, on the Base network (1 USDC pays for 100 verdicts). No ETH is needed: the x402 facilitator pays the gas. Never use your main wallet.
  2. Add the server to your MCP client, for example claude_desktop_config.json:
json
{  "mcpServers": {    "base-facts": {      "command": "npx",      "args": ["-y", "base-facts-mcp"],      "env": {        "X402_PAYER_FILE": "/path/to/payer.json",        "MAX_PRICE_USD": "0.02",        "SESSION_BUDGET_USD": "1"      }    }  }}

payer.json is { "privateKey": "0x..." }; X402_PRIVATE_KEY works too. Without either, the server uses ~/.base-facts-mcp/payer.json when it exists.

Every setting also exists as an option, for hosts that pass only command and args (Preste): --payer-file <path>, --max-price <usd>, --budget <usd>, --api <url>. See integrations/preste/ for the Preste config and skill.

Spending safety

  • MAX_PRICE_USD (default 0.02): the client refuses to sign any single payment above it.
  • SESSION_BUDGET_USD (default 1): once reached, the client stops signing until restarted.
  • Only USDC on Base (eip155:8453) is ever signed.
  • A refused or failed call (4xx/5xx) cancels the settlement: you are not charged, and the tool says charged: false with the reason (for example not enough USDC).
  • Paid calls run one at a time so the budget count stays exact.

Development

npm test drives the server over stdio like a real client, with empty wallets: no USDC is spent.

來源：README.md，提交 9ad460f

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.2.1最新Oct 6, 2026