token-security-mcp
by harrxzz
README.md
# Token Security Data API — paid x402 MCP server on Arc
Raw on-chain security + market facts for any token, sold per-request via the
[x402](https://x402.org) payment protocol on **Arc mainnet**. No scores, no
opinions, no advice — verifiable data only. The buyer decides.
**Endpoint:** `https://security.dexsec.my.id/mcp` (StreamableHTTP)
**Price:** `0.01 USDC` per `token_security` call · **free** `ping`
## Tools
| Tool | Cost | Description |
| --- | --- | --- |
| `ping` | free | Health check + endpoint directory |
| `token_security` | 0.01 USDC | Honeypot, taxes, renounce, lock, top-10 holder concentration, liquidity, socials |
```jsonc
token_security({
chain: "sol" | "base" | "bsc" | "rh", // rh = Robinhood Chain
address: "<token contract / mint address>"
})
```
## Why raw data, not scores
A score is a liability. If a token rugs after we score it 8/10, someone blames
us. Raw facts (is_honeypot, buy_tax, top_10_holder_rate, liquidity_usd) are
verifiable on-chain. The buyer pays for **data**, keeps the **judgment**.
## Payment
x402 v2, exact scheme:
- **network:** `eip155:5042` (Arc mainnet)
- **asset:** USDC (`0x3600…0000`) via EIP-3009 transfer-with-authorization
- **facilitator:** Circle (`https://api.circle.com/v1/facilitator/x402`)
Send the signed payment in the `X-PAYMENT` header (base64url JSON). A missing or
invalid payment returns `402` with `paymentRequirements` in
`WWW-Authenticate: x402 …`.
## Run your own
Node 20+, no database, no Docker:
```bash
git clone https://github.com/harrxzz/token-security-mcp
cd token-security-mcp
npm i
echo 'SELLER_PRIVATE_KEY=0x… # receives USDC' > .env
node security-server.js # listens :3000
```
Put it behind a Cloudflare Tunnel (free) for a public URL. That is exactly how
the live endpoint above is hosted.
## Operator
Operated by an independent agent infrastructure provider. Settled real 0.01 USDC
in testing. Pay-to address:
[`0xd509551234F6A43324F5D796EFd1e88341572cE4`](https://explorer.arc.io/address/0xd509551234F6A43324F5D796EFd1e88341572cE4)
## License
MIT