Skip to main content
Glama

solguard-mcp — Solana Token-2022 Honeypot Scanner MCP, quote-api.jup.ag ENOTFOUND Rescue & Jito bundleOnly Safe-Swap / Safe-Exit SDK

Zero Dependencies Node >=18 MCP 2024-11-05 Live Edge Telegram 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) — 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):

# 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).


Related MCP server: SolGuard

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:

{
  "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:

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

# 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

// 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:

npm install --allow-git=all github:Tradelord223/solguard-mcp
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 — 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides post-deploy Solana threat intelligence, enabling AI agents to check operators, tokens, and network stats for detecting rug pulls and malicious activity.
      5
      44 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      On-chain Solana token safety for trading agents — traces coordinated wallet funding, same-block Jito bundles, serial-rug deployers and live coordinated dumps into one Exit-Liquidity Risk verdict before a swap. Free tier, then $0.02 USDC/query via x402.
      1
      103 npm
      2
      MIT