Skip to main content
Glama
README.md
# `solguard-mcp` — Solana Token-2022 Honeypot Scanner MCP, `quote-api.jup.ag ENOTFOUND` Rescue & Jito `bundleOnly` Safe-Swap / Safe-Exit SDK

[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](#)
[![Node >=18](https://img.shields.io/badge/node-%3E%3D18.0.0-blue)](#)
[![MCP 2024-11-05](https://img.shields.io/badge/MCP-stdio%20%2B%20HTTP-purple)](https://solguard.lucky-bread-71e9.workers.dev/mcp)
[![Live Edge](https://img.shields.io/badge/Cloudflare%20Edge-24%2F7%20Live-orange)](https://solguard.lucky-bread-71e9.workers.dev)
[![Telegram Alerts](https://img.shields.io/badge/Telegram%20Alerts-%40Solguardscannerbot-26A5E4?logo=telegram)](https://t.me/Solguardscannerbot?start=alerts)

Zero-dependency **Model Context Protocol (MCP)** server and **JavaScript / TypeScript SDK** connected to the live **SolGuard** edge router (`https://solguard.lucky-bread-71e9.workers.dev`).

> **📲 24/7 Live Telegram Forensic & Alpha Alerts:** Subscribe on Telegram via [**`@Solguardscannerbot`**](https://t.me/Solguardscannerbot?start=alerts) (`https://t.me/Solguardscannerbot?start=alerts`) — or add `@Solguardscannerbot` to any Solana group/channel for automated 15-minute Mainnet Token-2022 rug alerts, clean `<180 bps` movers, and 1-click Jito Safe-Swap / Safe-Exit cards!

Run directly from GitHub in `<1 second` on any machine worldwide (zero `npm` login, zero API keys, zero `node_modules` bloat):

```bash
# Universal 1-command run from GitHub (npm 8–12+, zero npm login):
npx --allow-git=all -y github:Tradelord223/solguard-mcp --self-test
```

---

## Why Solana Bots & AI Agents Break in 2026

1. **`getaddrinfo ENOTFOUND quote-api.jup.ag`:** Legacy Solana bots, ElizaOS plugins, LangChain tools, and tutorials hardcoded `https://quote-api.jup.ag/v6/quote`, whose DNS was sunset.
2. **Token-2022 Poison Extensions:** Modern Solana rug pulls hide `permanentDelegate` (issuer seizes tokens from your wallet post-buy), `transferHook` (reverts non-whitelisted sells), `pausableConfig`, `nonTransferable`, and `99%` `transferFeeConfig` taxes behind `$500k+` boosted DEX liquidity.
3. **Public-Mempool Sandwich MEV:** Broadcasting swaps without Jito `bundleOnly=true` leaks slippage to sandwich validators.

**SolGuard** solves all three at the edge in `<2 seconds`:
- **Drop-In `/v6/quote` & `/v6/swap` Rescue:** Point legacy Jupiter v6 code to `https://solguard.lucky-bread-71e9.workers.dev`.
- **Live Mainnet Forensic Pre-Flight:** Inspects `getAccountInfo` (`jsonParsed`) + `1.0 SOL -> Token -> SOL` Jupiter round-trip impact in basis points, whitelisting canonical regulated stablecoins (`USDC`, `USDT`, `PYUSD`, `USDS`) while hard-blocking rug traps (`HTTP 400`).
- **Round-Trip Jito `bundleOnly=true` Execution (`buildSafeSwap` + `buildSafeExit`):** Builds v0 `VersionedTransaction` packets with full Address Lookup Table (ALT) support, Jito tips, and `65 bps` atomic native `SOL` fee routing on both **buys (`SOL -> Token`)** and **sells (`Token -> SOL` post-unwrap)**.

---

## 1. Connect as an MCP Server (Claude Desktop, Cursor, Windsurf, Cline, Codex)

### Option A: Local `stdio` via GitHub `npx` (Works Everywhere, Zero Install)

Add to **`claude_desktop_config.json`** or Cursor **`.cursor/mcp.json`**:

```json
{
  "mcpServers": {
    "solguard": {
      "command": "npx",
      "args": ["--allow-git=all", "-y", "github:Tradelord223/solguard-mcp"]
    }
  }
}
```

### Option B: Zero-Install Remote HTTP MCP

Point any Streamable-HTTP / JSON-RPC 2.0 MCP client directly to:

```text
https://solguard.lucky-bread-71e9.workers.dev/mcp
```

### MCP Tools Exposed

| MCP Tool | Purpose |
| :--- | :--- |
| `solana_token_forensic_audit` | Live Mainnet inspection of `mintAuthority`, `freezeAuthority`, Token-2022 hooks (`permanentDelegate`, `transferHook`, `pausableConfig`, `nonTransferable`, `transferFeeConfig`), DEX liquidity, and `1.0 SOL -> Token -> SOL` round-trip impact in bps. |
| `build_jito_safe_swap` | Verifies target mint is clean, then builds an unsigned v0 `VersionedTransaction` (`SOL -> Token` buy) with Jupiter route + Jito tip + `65 bps` atomic `SOL` fee. |
| `build_jito_safe_exit` | Builds an unsigned v0 `VersionedTransaction` (`Token -> SOL` sell / emergency dump) unwrapping proceeds to native `SOL` and paying the `65 bps` atomic fee out of sale proceeds (works even with near-zero free `SOL`). |

---

## 2. 1-Line Fix for `quote-api.jup.ag/v6 ENOTFOUND`

### cURL / Any Language
```bash
# Dead legacy endpoint (throws ENOTFOUND):
# curl "https://quote-api.jup.ag/v6/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&amount=100000000&slippageBps=100"

# Live SolGuard Edge Drop-In Rescue:
curl -s "https://solguard.lucky-bread-71e9.workers.dev/v6/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&amount=100000000&slippageBps=100"
```

### `@jup-ag/api` 1-Line Migration
```javascript
// Replace: import { createJupiterApiClient } from "@jup-ag/api";
import { createJupiterApiClient } from "solguard-mcp";

const jupiterQuoteApi = createJupiterApiClient();
const quote = await jupiterQuoteApi.quoteGet({
  inputMint: "So11111111111111111111111111111111111111112",
  outputMint: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  amount: 100_000_000,
  slippageBps: 100,
});
```

---

## 3. JavaScript / TypeScript SDK: Audit, Buy (`buildSafeSwap`) & Sell (`buildSafeExit`)

Install straight from GitHub:

```bash
npm install --allow-git=all github:Tradelord223/solguard-mcp
```

```javascript
import { VersionedTransaction } from "@solana/web3.js";
import { solguard } from "solguard-mcp";

const BONK = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";

// 1. Free 2-second Mainnet Token-2022 & round-trip slippage audit
const audit = await solguard.auditToken(BONK);
if (!audit.safeToSwap) throw new Error(`Blocked trap: ${audit.flags.join(", ")}`);

// 2. Build Jito-protected Buy (SOL -> Token)
const buyBuilt = await solguard.buildSafeSwap({
  userPublicKey: wallet.publicKey.toBase58(),
  outputMint: BONK,
  amountSol: 0.5,
  slippageBps: 100,
});
const buyTx = VersionedTransaction.deserialize(Buffer.from(buyBuilt.swapTransaction, "base64"));
buyTx.sign([wallet]);
const buyRes = await solguard.broadcastJitoBundle(Buffer.from(buyTx.serialize()).toString("base64"));
console.log("Buy confirmed via Jito:", buyRes.solscanUrl);

// 3. Build Jito-protected Safe-Exit (Token -> SOL, pays 65 bps from unwrapped SOL proceeds!)
const exitBuilt = await solguard.buildSafeExit({
  userPublicKey: wallet.publicKey.toBase58(),
  inputMint: BONK,
  amountRaw: buyBuilt.quote.outAmount,
  slippageBps: 150,
});
const exitTx = VersionedTransaction.deserialize(Buffer.from(exitBuilt.swapTransaction, "base64"));
exitTx.sign([wallet]);
const exitRes = await solguard.broadcastJitoBundle(Buffer.from(exitTx.serialize()).toString("base64"));
console.log("Safe-Exit confirmed via Jito:", exitRes.solscanUrl);
```

---

## 4. Live Mainnet Forensic Benchmarks

| Token | Mint | Mainnet Findings | `1.0 SOL` Round-Trip | SolGuard Verdict |
| :--- | :--- | :--- | :--- | :--- |
| **`$TTWO`** | `TTWofwAge91oFhZs7kpQdyrVRkmevgM88xijGvQFbKo` | Token-2022 `permanentDelegate` + `pausableConfig` | Blocked pre-quote | `DANGER_TRAP` (Hard-Blocked) |
| **`$ANT`** | `H5imUBBArRQhKxvBLJhb73ghXscbEgGpriRxCxyHrise` | Active `mintAuthority` (`$1.36M` DEX liq) | Unsellable exit | `DANGER_TRAP` (Hard-Blocked) |
| **`$PYUSD`** | `2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo` | Canonical regulated USD stablecoin whitelist | `< 5 bps` | `CLEAN` (`safeToSwap: true`) |
| **`$BONK`** | `DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263` | Mint & Freeze revoked, 0 Token-2022 hooks | `~3 bps` | `CLEAN` (`safeToSwap: true`) |

Verify any mint interactively in 2 seconds:
`https://solguard.lucky-bread-71e9.workers.dev/check/TTWofwAge91oFhZs7kpQdyrVRkmevgM88xijGvQFbKo`

---

## 5. Live Telegram Bot (`@Solguardscannerbot`), Solana Blinks v2.2 & `x402` Feed

- **📲 Live Telegram Forensic & Alpha Alerts (`@Solguardscannerbot`):** [`https://t.me/Solguardscannerbot?start=alerts`](https://t.me/Solguardscannerbot?start=alerts) — paste any Solana mint for a `<2.5s` Token-2022 audit + 1-click Jito swap card, or subscribe to automated 15-minute Mainnet rug & clean-mover broadcasts.
- **Interactive Scanner & Phantom/Solflare/Backpack Safe-Swap UI:** `https://solguard.lucky-bread-71e9.workers.dev`
- **Solana Blinks (`actions.json`):** `https://solguard.lucky-bread-71e9.workers.dev/api/actions/swap/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263` (unfurls directly on X/Twitter & Dialect with quick-buy and Safe-Exit actions)
- **`x402` Real-Time Clean Alpha Feed (`0.002 SOL` 24h pass):** `GET https://solguard.lucky-bread-71e9.workers.dev/api/v1/alpha-feed` (pass confirmed Mainnet payment signature in `X-Payment-Signature`)
- **Live Rug Radar RSS & Trending Scan:** `/feed.xml` • `/api/v1/trending-audit` • `/openapi.json` • `/.well-known/agent.json` • `/llms.txt`

## License

MIT © SolGuard Protocol