MCP.Market

Base Token Facts MCP server

by yankiifr·io.github.yankiifr/base-facts-mcp·v0.2.3
No reviews yet

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

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars478 downloads/wk

Reviews

Write one

Nobody has reviewed Base Token Facts yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Base Token Facts tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • base_facts_budget

    How much this session has paid, the per-call cap and the session budget. Free.

  • base_gas

    Current Base base fee, max priority fee, gas price (wei) and block usage. Costs $0.001.

  • base_token_facts

    Raw on-chain facts about a Base token contract: ERC20 metadata, owner(), proxy standard and implementation, admin function selectors found in the bytecode, block number. Costs $0.005.

  • base_token_sellcheck

    Honeypot and tax check for a Base token: simulates a small buy and an immediate sell on its deepest pool (Uniswap v2/v3/v4, Aerodrome) inside eth_call. Returns buy tax, sell tax, round-trip loss and whether the sell reverted. Paid with x402 from your payer wallet.

  • base_token_sellcheck_size

    The sell check at YOUR size: simulates a buy of amountEth (0.001 to 10 ETH) and an immediate sell inside eth_call. Returns buy tax, sell tax, round-trip loss, the buy price impact against a small trade (buyPriceImpactPct) and a depthWarning when the size is larger than the pool can absorb. Costs $0.01.

  • base_token_verdict

    Before buying a token on Base: risk level, score and flags (upgradeable proxy, mint, pause, blacklist, owner not renounced, DEX liquidity on Uniswap v2/v3 and Aerodrome), each with the on-chain fact behind it. Facts and heuristics, not financial advice. Costs $0.01 in USDC.

  • base_tx_summary

    Status, from/to, gas used, fee in ETH and decoded ERC20 transfers of a Base transaction. Costs $0.003.

  • base_wallet_snapshot

    ETH and USDC balances, transaction count (nonce) and whether the address is a contract, on Base. Costs $0.002.

  • basename_resolve

    Resolve a Basename (name.base.eth) to its address, or an address to its verified primary Basename. Give exactly one of name or address. Costs $0.002.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 3 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Base Token Facts compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
9
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
478
more than 87% of 12,191 servers with a package

What its tools let an agent do: 9 read

Install Base Token Facts in Claude Code, Cursor or VS Code

Runs npx -y base-facts-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add base-facts-mcp -- npx -y base-facts-mcp
Add to Cursor

What the publisher says

From the Base Token Facts repository's README, as published. We do not edit it. Read it on GitHub

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.

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

100 verdicts). No ETH is needed: the x402 facilitator pays the gas. Never use your main wallet.

  1. Make a dedicated wallet and put a little USDC on it, on the Base network (1 USDC pays for
  1. Add the server to your MCP client, for example claudedesktopconfig.json:
{
  "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 is { "privateKey": "0x..." }; X402PRIVATEKEY 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 , --max-price , --budget , --api . See integrations/preste/ for the Preste config and skill.

Spending safety

charged: false with the reason (for example not enough USDC).

  • MAXPRICEUSD (default 0.03): the client refuses to sign any single payment above it.
  • SESSIONBUDGETUSD (default 1): once reached, the client stops signing until restarted.
  • BASEFACTSPAYTO (default: the official address when using the default API): the only recipient the client will sign for. Required with a custom BASEFACTS_URL; without it nothing is signed. The client also signs only Base USDC (0x8335…2913).
  • 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
  • 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.

Nothing above is checked by us. What we check is on the safety report.

Base Token Facts: common questions

Is Base Token Facts MCP server safe?
Mostly: it is graded B (83/100). Read the Base Token Facts safety report
How do I install Base Token Facts?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Base Token Facts need an API key?
Yes. The registry entry asks for X402_PRIVATE_KEY.
Is Base Token Facts maintained?
The last commit was 24 days ago (2026-10-11). The latest release is v0.2.3.
How does Base Token Facts compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.