English Français العربية

io.github.aitools420/onchain-safety-mcp

Official registry AI and agents

Token-safety for AI agents: rug/honeypot verdict + score across PulseChain, Monad, Base & BSC

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @wickpics/onchain-safety-mcp
Claude Code 
claude mcp add onchain-safety-mcp -e 'ONCHAIN_API_KEY=<your onchain_api_key>' -- npx -y @wickpics/onchain-safety-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "onchain-safety-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@wickpics/onchain-safety-mcp@0.2.0"
            ],
            "env": {
                "ONCHAIN_API_KEY": "<your onchain_api_key>"
            }
        }
    }
}

Environment variables

  • ONCHAIN_API_KEY secret Optional wsk_ key for the paid deep tier (omit for the free rate-limited tier).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. onchain-safety-mcp
  2. Tools
  3. Install (any MCP client — Claude Desktop, agent frameworks)
  4. Pay-per-call for autonomous agents (x402)
  5. Env
  6. License

onchain-safety-mcp

MCP (Model Context Protocol) server that gives any AI agent on-chain token-safety tools for PulseChain, Monad, Base, and BSC — including PulseChain, which the major token-safety APIs (GoPlus, Honeypot.is) don't support at all (verified June 2026). If your agent touches PulseChain, this is the safety check.

It is a thin stdio client over the hosted API at onchain.wick.pics (engine wick-safe/0.3). Every check is deterministic on-chain analysis — no LLM in the verdict path, so results are fast, cheap, and reproducible: contract-risk heuristics, liquidity depth, honeypot transfer-simulation, LP-burn, ownership/renounce + privilege detection, upgradeable-proxy detection, and a wallet approval (drainer) scanner. The free tier needs no key. Informational, not financial advice.

Tools

toolwhat it answers
check_token_safety({ chain, address })Is this token a scam? Verdict (SAFE … LIKELY_RUG), 0–100 score, evidence checks.
fresh_rug_radar()What just launched, and is it safe? Last 20 freshly-created pools, safety-scored at creation.
exit_safety({ chain, token, sizeUsd, maxSlippage? })Could I sell $X of this at acceptable slippage? Size-aware price impact + safety verdict.
check_ownership({ chain, address })Is ownership renounced / upgradeable, and what can an active owner still do (mint, blacklist, pause, tax)?
safe_to_interact({ chain, address })One call → SAFE_TO_INTERACT / CAUTION / DO_NOT_INTERACT, bundling safety + ownership, with reasons.
wallet_approvals({ chain, owner })A wallet's active ERC-20 approvals, flagging unlimited grants — the drainer vector.
wallet_poison_check({ chain, owner })Address-poisoning scan: dust/look-alike transfers in a wallet's history that mimic a real counterparty to trick a paste-and-send of the wrong address.

chain: pulsechain | monad | base | bsc · token/address: 0x… contract address. Agents should call check_token_safety / exit_safety before interacting with, buying, or accepting an unknown token.

Install (any MCP client — Claude Desktop, agent frameworks)

{
  "mcpServers": {
    "onchain-safety": {
      "command": "npx",
      "args": ["-y", "github:aitools420/onchain-safety-mcp"],
      "env": { "ONCHAIN_API_KEY": "wsk_…" }
    }
  }
}

ONCHAIN_API_KEY is optional — omit it for the free rate-limited tier. A wsk_ key unlocks the paid deep tier (get one at onchain.wick.pics).

Pay-per-call for autonomous agents (x402)

The same engine is available with no signup and no key via the x402 pay-per-call protocol — agents pay USDC on Base per request. Machine-readable index of every paid route (token-safety, fresh-rug radar, exit-safety):

https://onchain.wick.pics/.well-known/x402.json

Human docs: onchain.wick.pics/agents

Env

vardefaultpurpose
ONCHAIN_API_BASEhttps://onchain.wick.picsAPI host
ONCHAIN_API_KEY(none — free tier)wsk_ key for the paid deep tier

License

MIT

Frequently asked questions

What is io.github.aitools420/onchain-safety-mcp?

Token-safety for AI agents: rug/honeypot verdict + score across PulseChain, Monad, Base & BSC

How do I install io.github.aitools420/onchain-safety-mcp?

It runs on your machine. In Claude Code: claude mcp add onchain-safety-mcp -e 'ONCHAIN_API_KEY=<your onchain_api_key>' -- npx -y @wickpics/onchain-safety-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.aitools420/onchain-safety-mcp need an API key?

Yes. It expects ONCHAIN_API_KEY, which you set in its configuration.

Is io.github.aitools420/onchain-safety-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.aitools420/onchain-safety-mcp?

It is published by aitools420. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.