# Archalis Radar MCP server

Risk ratings (AAA to C) and rug pull forensics for **BNB Chain** tokens, for AI agents and trading bots.

Archalis Radar rates tokens like a credit rating agency and reconstructs on-chain how rug pulls happened. This MCP server lets an agent ask for a token's rating, check a wallet, read liquidity alerts and judge how reliable the ratings are.

- Endpoint: `https://api.archalis.com/v1/mcp` (Streamable HTTP, JSON responses, no session)
- Works **without an API key** on the free plan (1000 requests a day). A key raises the limits.
- Docs: https://docs.archalis.com/#mcp · OpenAPI: https://docs.archalis.com/openapi.json · Site: https://archalis.com

## Tools

| Tool | What it returns |
|---|---|
| `get_token_rating` | Rating of a BNB Chain token with risk flags, simulated buy/sell taxes, who controls the contract and the liquidity, the creator history and, after a collapse, who took the money out. Tokens without a readable market are not rated, and the answer says why. |
| `check_wallet` | Pools a wallet created and how they ended, other roles in pools, who funded it, which wallets it funded and the network of linked creators it belongs to. |
| `get_liquidity_alerts` | Alerts when a pool loses 40% (`liquidity_falling`) or 70% or more (`liquidity_collapsed`) of its peak liquidity. The free plan sees them with a 60-second delay. |
| `get_rating_track_record` | How often new pools ended in a rug pull after each first grade, so the reliability of the ratings can be judged. |

## Install

Claude Code:

```bash
claude mcp add --transport http archalis https://api.archalis.com/v1/mcp
```

Any client that reads a JSON config:

```json
{
  "mcpServers": {
    "archalis": { "type": "http", "url": "https://api.archalis.com/v1/mcp" }
  }
}
```

For higher limits add the header `X-API-Key: ark_...`.

## Example questions

- Is `0x...` on BNB Chain a rug pull risk?
- What did this wallet launch before, and how did it end?
- How reliable are Archalis ratings so far?

## Also

[bsc-honeypot-check](https://github.com/ArchalisRadar/bsc-honeypot-check): a one-file honeypot and sell-tax check on the same API.

## Limits

Covers BNB Chain only. Ratings measure observed structural risk, not price potential, and a token that cannot be simulated is reported as unknown, never as safe. Automated assessments, not financial advice.

MIT license (this repository: documentation and configuration). The radar itself is a hosted service.