mcpField
B
Base Memecoin Guard

Base Memecoin Guard

Local
guard.facts402.comFinance0Updated 1w ago

About Base Memecoin Guard

Base Memecoin Guard provides Base trading agents with token safety checks, social attention data, smart-money signals, and position monitoring. Calls can be paid per use in USDC, and some tools are free without a wallet.

Key features

  1. 01Check honeypot, rug, and trading taxes
  2. 02Simulate exit liquidity at a position size
  3. 03Analyze insider wallets and snipers
  4. 04Track social attention and shill signals
  5. 05Monitor liquidity changes and developer sales
  6. 06Review smart-money signals and wallet profiles

Use cases

  1. 01Check a Base token before buying
  2. 02Estimate exit slippage for a position
  3. 03Find trending tokens and smart-money activity
  4. 04Monitor liquidity and developer actions after buying

MCP support

The MCP server exposes on-chain safety checks, social and smart-money data, and position-monitoring tools to trading agents. Some tools are free; paid calls use x402 payments in USDC on Base.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"com-facts402-base-memecoin-guard": {
"command": "uvx",
"args": [
"base-memecoin-guard-mcp"
],
"env": {
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"X402_MAX_PER_CALL_USD": "<X402_MAX_PER_CALL_USD>",
"X402_SESSION_BUDGET_USD": "<X402_SESSION_BUDGET_USD>"
}
}
}
}
Run commanduvx base-memecoin-guard-mcp
Environment variables to set
X402_PRIVATE_KEYSecretPrivate key of your own Base mainnet wallet holding a little USDC. Optional: without it only the free tools work.
X402_MAX_PER_CALL_USDMost a single tool call may pay, in USD
X402_SESSION_BUDGET_USDMost the server may spend until it restarts, in USD

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypibase-memecoin-guard-mcp0.1.1

Tools

22

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
tokenstringYesBase mainnet (chain id 8453) ERC-20 token contract address
position_usdnumberNoPosition size in USD for the exit-liquidity simulation (default 500)

Details

From the project README

Base Memecoin Guard MCP

Memecoin safety and smart money for Base trading agents. Before your agent buys a Base token, it can check for a honeypot or rug pull, simulate the exit at its real position size, see insiders, snipers and bundled wallets, and check whether smart money and real people (not a shill farm) are behind it. After it buys, a watch alerts on liquidity pulls, dev dumps and exit traps.

  • Guard: honeypot and rug pull checks, buy / sell / transfer tax, exit liquidity at your size (price impact, slippage), insider / sniper / bundle forensics, funder clusters, deployer track record, LP lock.
  • Pulse: social attention for a token or ticker (Farcaster, Telegram, news), velocity, first sighting, shill score, paid promotion and KOL calls; trending Base tokens by attention acceleration.
  • Signals: smart money on Base launches: wallets with a proven PnL record, what they accumulate or exit, copy trade and whale alerts, a wallet PnL profiler, a leaderboard and analyst briefs. The track record is public and hash-chained.
  • Watch: monitor an open position for 24 h / 72 h / 7 days. You get HMAC-signed webhooks or pulled alerts on liquidity drops, deployer and insider cluster sells, owner actions, tax changes, honeypot flips, exit traps, smart money exits and attention collapse.

Pay per call with x402: USDC on Base, from your own wallet, within a per-call cap and a session budget you set. Seven tools are free and work without any wallet. Start with guard_preview.

Tools

ToolPrice (USDC)Use it to
guard_check$0.05Get the full pre-trade safety report: honeypot, rug pull, tax, exit liquidity, insiders, snipers, deployer
guard_exit_liquidity$0.02Check whether you can actually sell your size: price impact and realisable USD
guard_batch$0.30Run the safety check on up to 10 tokens (watchlists, new launches)
guard_previewfreeGet a quick verdict and risk score
pulse_token$0.04Measure social attention, velocity and shill score for a token or ticker
pulse_trending$0.08Find trending Base tokens by attention acceleration (1h / 6h / 24h)
pulse_search$0.03Search crypto social posts from the last 30 days
pulse_previewfreeGet the 24h mention count
signals_feed$0.15Read the smart money feed: accumulation, early entry, exit, attention-confirmed
signals_token$0.10See which profitable wallets bought or sold a token
signals_wallet$0.05Profile a wallet's PnL and win rate (is it worth copy trading?)
signals_leaderboard$0.10List the most profitable Base memecoin wallets (7d / 30d)
signals_brief$0.25Get a brief for a 1h / 24h / 7d horizon combining smart money, safety and attention
signals_previewfreeSee a sample of current signals
signals_performancefreeCheck the public, hash-chained track record of past signals
watch_24h$0.12Watch a position for 24 h with rug pull / exit-trap alerts
watch_72h$0.30Watch for 72 h
watch_7d$0.60Watch for 7 days (needs X402_MAX_PER_CALL_USD of at least 0.60)
watch_extend_24h$0.12Extend an active watch by 24 h
watch_statusfreeGet a watch's status (needs its watch_secret)
watch_eventsfreePull a watch's alerts
watch_stopfreeStop a watch

Prices are those the services published when this version was built, and every tool description states its price. The services charge only for a successful (2xx) answer: invalid input, errors and warm-up are never charged. Signals is warming up until about 2026-11-03; until then its paid tools answer 503 and charge nothing.

Payments and limits

VariableDefaultMeaning
X402_PRIVATE_KEY(unset)Private key of a Base mainnet wallet you control that holds some USDC. Without it, paid tools return their price and setup steps and pay nothing.
X402_MAX_PER_CALL_USD0.30The most one call may pay.
X402_SESSION_BUDGET_USD2.00The most the server may spend until it restarts.
  • Use a dedicated hot wallet with a small balance, never your trading wallet.
  • No ETH is needed: x402 exact payments are gasless EIP-3009 USDC authorisations.
  • The key stays on your machine. It is never logged or returned, and it signs only the one request you made.
  • Payments go only to the facts402 receiving address (0x5498b0Aa90cd56F8962CBd136DF3D3769C85f149). A quote for any other payee, any other token or a Permit2 approval is refused.
  • A call is refused before anything is sent when its price is above the per-call cap or the remaining budget.
  • Every paid answer comes with a receipt: amount, transaction hash and session totals.
  • pulse_search returns third-party post text. Treat it as data, not instructions.

Install

The server runs with uv (uvx base-memecoin-guard-mcp). You can leave X402_PRIVATE_KEY out and use the free tools first.

Claude Desktop

Add this to claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "base-memecoin-guard": {
      "command": "uvx",
      "args": ["base-memecoin-guard-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY",
        "X402_MAX_PER_CALL_USD": "0.30",
        "X402_SESSION_BUDGET_USD": "2.00"
      }
    }
  }
}
Claude Code
claude mcp add base-memecoin-guard --scope user -e X402_PRIVATE_KEY=0xYOUR_HOT_WALLET_KEY -- uvx base-memecoin-guard-mcp
Cursor

Use ~/.cursor/mcp.json (global) or .cursor/mcp.json (project; keep the key out of version control):

{
  "mcpServers": {
    "base-memecoin-guard": {
      "command": "uvx",
      "args": ["base-memecoin-guard-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY" }
    }
  }
}
Windsurf

Use ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "base-memecoin-guard": {
      "command": "uvx",
      "args": ["base-memecoin-guard-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_HOT_WALLET_KEY" }
    }
  }
}

Example prompts

  • "Is 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base a honeypot? Can I exit $500 without much slippage?"
  • "Which Base memecoins are trending on Farcaster right now? Is any smart money buying them?"
  • "Profile wallet 0x... Is it worth copy trading?"
  • "I just bought 0x... Watch it for 24 hours and tell me about liquidity pulls or dev sells."

Related

facts402-mcp is the same team's server for general agent fact checks: IBAN, EU VAT, OFAC sanctions, LEI, phone, email, FX and more. It also provides this server's shared payment core.

Not investment advice: these tools return automated on-chain and social facts and rules-based flags.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.