# chaink9 [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/ChainK9/chaink9-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 837  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/chaink9

## Description
Token risk checks on BSC, Ethereum and Base: trades the token on a fork. Paid in USDC via x402.

## Tools
Capabilities this server exposes over MCP:

- **verdict** — Free. ChainK9's latest stored verdict (danger, caution or ok) for a token on BNB Smart Chain, Ethereum, Base or Arc, with the names of the checks that failed or warned and when it was scanned. Most funded new launches are scanned within minutes. For the evidence behind each check use the paid report tool; for a fresh check use scan-lite, scan or scan-ultra.
- **simulate-trade** — Execute a requested-wallet buy or sell on a disposable fork of BNB Smart Chain, Ethereum, Base or Arc. Trades the token's market as a scan finds it: its funded V2 pair, else its deepest V3 pool, else its recorded Uniswap V4 pool (hook included), against BNB/WBNB or ETH/WETH; actual wallet balances, EOA wallets only. Returns receipt status, received amount, the market traded (pool_version, pool, fee_tier, hooks), router quote shortfall and gas. A V4 quote already includes the hook's cut. A quote shortfall is not a pure tax or price-impact measurement. Sell approval is simulated when needed; no live transaction is sent. Costs $0.02 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **exit-check** — Test up to four independent sell sizes from an EOA's existing token balance. Each size starts from the same fork snapshot; approvals are included when needed. Sells through the token's V2, V3 or V4 market (as simulate-trade finds it) with the wallet's real BNB or ETH for gas. Returns observed sell outcomes, not a guarantee of future exit. Costs $0.04 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **risk-changes** — Compare the latest two stored ChainK9 scans. Returns changed, added and removed module results plus report timestamps. Does not run a new scan or independently verify implementation changes. Requires two saved scans; 404 is not charged. Costs $0.002 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **deployer-report** — Verify a token's successful finalized top-level creation transaction and return known verified deployments by that sender with stored scans. Coverage grows as creation proofs are submitted. Does not discover every deployment, trace launchpad/internal CREATE, attribute a team, or label a deployer a scammer. Costs $0.005 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **liquidity-report** — Read the token's market at one finalized block. A V3 or V4 pool returns pool_version, fee, hook, active liquidity, price and (V3) the coins the pool holds; its positions are NFTs, so holders and lock IDs are refused. A V2 pair returns canonical reserves against WBNB/WETH (PancakeSwap on BSC, Uniswap on Ethereum and Base), LP supply, burned LP and up to ten supplied holders. On BSC, optionally verify up to ten PinkLock V2 simple lock IDs against the pinned BSC contract, exact runtime hash and aggregate LP custody. Reports future, elapsed, withdrawn and unsupported vesting records. No holder/lock discovery or withdrawal simulation; other contract-held LP remains unknown. Lock and holder amounts overlap. Costs $0.003 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **launch-feed** — Filter the latest collector candidates on one chain for currently funded markets: canonical V2 and V3 pools against the wrapped coin with at least the minimum wrapped-coin reserve, and Uniswap V4 pools against the native or wrapped coin with active liquidity (V4 only when min_wrapped is zero, since a V4 pool's own coins can't be read); optional stored verdict. Checks at most twenty candidates at one finalized block. Ordered by pair creation, not first liquidity time; most funded markets are scanned in the background within minutes and re-scanned an hour later; unscanned markets are unknown and stored verdicts may be old. Costs $0.003 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **transaction-preview** — Execute an EOA transaction on a disposable fork of BNB Smart Chain, Ethereum, Base or Arc. Supply target, calldata, optional native-coin value and up to ten ERC-20 assets to track. Returns receipt status, native-coin balance delta including gas, requested token deltas and direct approve allowance reads when available. Other assets, internal approvals and signatures are not inventoried; nothing is broadcast live. Costs $0.02 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **portfolio-screen** — Read actual wallet balances for up to twenty supplied token addresses on one chain and prioritize their stored ChainK9 scan verdicts. Includes scan age/staleness and missing reports. Does not discover wallet assets, run fresh scans or establish wallet-specific sellability; use exit-check for that. Costs $0.005 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **scan** — Check a token on BNB Smart Chain, Ethereum, Base or Arc for traps before buying it. ChainK9 forks the chain and really buys and sells the token in a sandbox (its V2 or V3 pool: PancakeSwap on BSC, where a V2 pair against USDT or USDC is traded through BNB, Uniswap on Ethereum and Base; or its Uniswap V4 pool, hook included, against the native coin or, traded through it, USDT or USDC; on Arc, its V4 pool against USDC), then runs 70+ checks: honeypot, hidden and changing buy and sell taxes, owner pause, blacklist, mint and confiscation powers, transfer and sell limits, cooldowns, liquidity, upgrade authority. Returns a verdict (danger, caution, ok) and every check's result. Results are reused for 10 minutes. Not charged when the address isn't a token or has no liquidity yet (422). Costs $0.02 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **scan-lite** — A quicker, cheaper ChainK9 check for bots that need a fast yes or no before buying a token on BNB Smart Chain, Ethereum, Base or Arc. It really buys and sells the token once on a fork of the chain, then reads the contract: honeypot, buy and sell tax, trade gas, ownership, owner functions in the bytecode, blacklist, proxy, liquidity and source checks. It skips /scan's extra trades and time-travel probes (taxes that change over time or after several sells, owner powers tried for real, transfer limits and cooldowns), so a recent full /scan is returned instead when one exists. The report's tier field says which ran. Lite results are stored, so /report returns them later too. Not charged when the address isn't a token or has no liquidity yet (422). Costs $0.005 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **scan-ultra** — ChainK9's deepest token check on BNB Smart Chain, Ethereum, Base or Arc, for bigger buys and due diligence. Everything /scan does (a real buy and sell on a fork of the chain plus 70+ checks: honeypot, changing taxes, owner powers tried for real, limits, cooldowns, liquidity, upgrade authority), plus who holds the token: the largest holder's and the top 10's share of supply, ranked from the token's whole transfer history with the largest balances read on chain, and whether a single wallet holds the pool's liquidity tokens and could pull the liquidity. Holder checks cover tokens with up to about 10,000 transfers (most new launches) and say so when a token has more. A stored ultra result also answers /scan and /report. Not charged when the address isn't a token or has no liquidity yet (422). Costs $0.05 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **report** — The latest stored ChainK9 report for a token on BNB Smart Chain, Ethereum, Base or Arc, without running a new scan; its tier field says whether it was a lite, full or ultra scan. Most funded new launches are scanned in the background within minutes of their first liquidity and re-scanned an hour later, so this is usually the fastest answer for a new token. Not charged if the token was never scanned on that chain (404). Costs $0.002 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **trace** — Follow the money out of one transaction on BNB Smart Chain, Ethereum, Base or Arc, wallet to wallet: native coin anywhere in its call tree (so a drainer contract's payouts count) and every token transfer it logged, then each receiving wallet's outgoing transfers that pass that amount on (first in, first out, wallets funded twice followed once for the sum), up to depth hops (1 to 5, default 3). A swap doesn't end the trail: it continues with what came back. Each trail ends at a mixer (Tornado Cash pools and routers on Ethereum and BSC, labeled with the pool), a contract (exchange, bridge, router, pool; known ones labeled), a busy exchange or service wallet, a wallet still holding the funds, a burn, or the depth limit; ends lists which, with the amount that reached it. Up to 80 hops. Not charged if the transaction isn't found (404) or moved nothing (422). Costs $0.01 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
- **feed** — The newest tokens that just got a market on BNB Smart Chain (PancakeSwap), Ethereum, Base or Arc (Uniswap), newest first, with ChainK9's verdict where the token was scanned on that chain. Funded launches are usually scanned in the background within minutes, so most of them already carry a verdict. Costs $0.002 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "chaink9": {
    "command": "npx",
    "args": ["-y","chaink9-mcp"],
    "env": {
      "CHAINK9_PRIVATE_KEY": ""
    }
  }
}
```

**Requires environment variables:** `CHAINK9_PRIVATE_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What chaink9 MCP server does

chaink9 MCP server gives agents tools for token-risk analysis and on-chain investigation across BNB Smart Chain, Ethereum, Base, and Arc. Its distinguishing approach is behavioral: full scans execute a real buy and sell on a disposable fork through the token’s available V2, V3, or V4 market, including supported hooks, then run more than 60 checks.

The scan family covers honeypots, changing buy and sell taxes, owner controls, blacklists, minting and confiscation powers, trading limits, cooldowns, liquidity, and upgrade authority. `scan-lite` performs a faster, narrower check, while `scan-ultra` adds holder concentration and liquidity-token custody analysis. Stored results can be read with `report` or the free `verdict` tool.

## How it works

Most paid calls are charged in USDC on Base using x402. The local server signs payments from a dedicated wallet; the wallet only signs Base payments, and its private key remains on the machine. Failed calls, invalid inputs, missing liquidity, and similar unsuccessful requests are free. Per-call and daily spending limits can prevent unexpected usage.

The server also exposes tools for simulated buys and sells, sell-size testing, arbitrary transaction previews, pool inspection, launch discovery, scan comparisons, deployer reports, portfolio screening, and transaction tracing. Fork-based execution does not broadcast transactions to the live chain. Results describe observed behavior at the relevant block and should not be treated as a guarantee of future trading outcomes.

## Setup and configuration

Create a separate wallet, fund it with USDC on Base, and add the package to an MCP client with its private key:

```bash
claude mcp add chaink9 -e CHAINK9_PRIVATE_KEY=0x... -- npx -y chaink9-mcp
```

JSON-based clients can launch `npx -y chaink9-mcp` and provide `CHAINK9_PRIVATE_KEY` in the server environment. `CHAINK9_MAX_USD_PER_CALL` defaults to `0.05`, and `CHAINK9_MAX_USD_PER_DAY` defaults to `1`; daily spending is recorded in `~/.chaink9-mcp/spend.json`.

A hosted streamable-HTTP endpoint is also available at `https://api.chaink9.com/mcp`. It provides the same tools and a free `verdict` operation. Paid hosted calls require an x402-aware MCP client, such as the client created by `@x402/mcp`.

## Tools and capabilities

- Run full, lite, or ultra token scans and retrieve stored reports or verdicts.
- Simulate buys, sells, and up to four independent exit sizes using a wallet’s forked balances.
- Preview an EOA transaction and inspect native-coin and selected ERC-20 balance changes.
- Examine V2 reserves and LP information, or V3/V4 liquidity and pricing.
- Find newly funded markets, compare the latest two scans, and inspect known deployer activity.
- Screen supplied wallet holdings and trace native or token funds through transaction call trees.

Each tool accepts a chain selection, with BNB Smart Chain as the default. Paid prices vary by operation, from the low-cost stored-report and feed tools to the deeper ultra scan and exit-check.

## Limitations and notes

Scan results reflect execution on a private fork at a stated block. Owners may change token behavior afterward, and untested traps can remain. Portfolio screening reads only supplied token addresses and does not discover all wallet assets or prove wallet-specific sellability. Deployer reports cover verified creation transactions and known stored deployments, not every deployment or launchpad path.

Liquidity reporting differs by pool type: V2 data includes reserves and selected LP-holder information, while V3 and V4 data focuses on active liquidity and price. Holder and lock discovery is limited, and some LP custody remains unknown. Transaction tracing follows supported transfers to a bounded depth and can end at contracts, services, mixers, burns, wallets, or the depth limit.

_Full upstream README: https://allmcps.com/mcp/chaink9/readme_