Give your agent a radar

Quick start

The fastest path is Claude Code. Run this once:

claude mcp add --transport http radartrade /mcp

Then tell your agent the rule, for example in your CLAUDE.md or system prompt:

Before buying any Solana token, call radartrade scan_token with its mint.
Never buy on HOSTILE. On WATCH, use at most a quarter of normal size.

MCP setup

The server speaks MCP over Streamable HTTP at /mcp. It is stateless, needs no session and returns plain JSON.

Claude Code

claude mcp add --transport http radartrade /mcp

Claude Desktop and claude.ai

Open Settings → Connectors → Add custom connector, name it Radartrade and paste the URL:

/mcp

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "radartrade": { "url": "/mcp" }
  }
}

With an API key

Send the key as a header. In Claude Code:

claude mcp add --transport http radartrade /mcp --header "x-api-key: YOUR_KEY"

Tools

REST

Same report, plain HTTP. CORS is open, so browsers can call it too.

curl /v1/scan/MINT_ADDRESS
curl -H "x-api-key: YOUR_KEY" /v1/scan/MINT_ADDRESS

Responses carry x-ratelimit-limit and x-ratelimit-remaining headers.

The report

Abridged. Open any sweep and expand Raw JSON to see a full one.

{
  "mint": "…",
  "token":   { "name", "symbol", "image", "program", "decimals", "supply", "launchpad", "createdAt", "ageHours" },
  "score":   0-100,
  "verdict": "CLEAR" | "WATCH" | "HOSTILE",
  "summary": "Hostile: freeze authority is live and launch bundle still holds. Do not buy.",
  "flags": [
    { "id": "freeze_authority", "severity": "high", "penalty": 40,
      "label": "Freeze authority is live", "detail": "…" }
  ],
  "checks": {
    "authorities": { "mint", "freeze", "metadataUpdate", "issuer" },
    "token2022":   { "extensions", "permanentDelegate", "transferHook", "transferFeeBps", … } | null,
    "launch":      { "traced", "slot", "time", "creator", "dev": {…}, "bundle": {…} },
    "holders":     { "top10Pct", "top": [{ "owner", "pct" }], "programPct", "burnedPct" },
    "copycat":     { "mint", "symbol", "marketCap", "ratio" } | null,
    "market":      { "priceUsd", "marketCap", "liquidityUsd", "volume24h", "buys24h", "sells24h", … } | null
  },
  "partial": [ { "check": "holders", "error": "…" } ],
  "scannedAt": "…", "ms": 4210
}

partial lists checks that could not finish (a slow RPC, say). A failed check adds no penalty of its own, so an incomplete sweep gets an incomplete flag and is capped at 74: it can be WATCH or HOSTILE, never CLEAR.

Rules and penalties

The score starts at 100. Each rule that fires takes its penalty off. Some rules also set a ceiling the score can't go above. Calls: CLEAR 75–100, WATCH 45–74, HOSTILE 0–44.

How the launch block is traced

Radartrade walks the mint's history back to its first transaction (up to 6,000 deep), reads every successful transaction in that slot, and records each wallet that received tokens. The creator is the fee payer of the transaction that initialised the mint. Current balances come from each wallet's associated token account. Tokens with deeper history still get the creator and dev buy from the creation transaction, but not the full list of launch-block buyers.

Limits and keys

Without a key you get 30 sweeps a day per IP, reset at 00:00 UTC. Trending and health calls are free and unlimited. Agents that need more can get an API key with a higher daily allowance. Contact the team through the official channels in the footer.

Errors

Over MCP, the same errors come back as a tool result with isError: true and the message as text.