SolGuard MCP & Safe-Swap SDK

Zero-dependency Solana Token-2022 Honeypot Firewall, quote-api.jup.ag/v6 DNS Rescue & Jito bundleOnly=true Buy / Post-Unwrap Safe-Exit Router
_{Connect in 5 seconds via Zero-Install Remote HTTP MCP (0 npm / 0 local Node) or 1-command GitHub npx.}

---

Architecture & Non-Custodial Execution Pipeline

1. Live Mainnet Forensic Pre-Flight (<2s): Inspects mintAuthority, freezeAuthority, Token-2022 poison hooks (permanentDelegate, transferHook, pausableConfig, nonTransferable, transferFeeConfig), DEX liquidity, and a live 1.0 SOL -> Token -> SOL Jupiter round-trip simulation in basis points.
2. Sunset quote-api.jup.ag/v6 Drop-In Rescue: Replaces dead quote-api.jup.ag endpoints in 1 line while blocking honeypot mints (HTTP 400) before wallet signing.
3. Round-Trip Jito bundleOnly=true v0 Builders (buildSafeSwap + buildSafeExit): Compiles unsigned v0 VersionedTransaction packets with full Address Lookup Table (ALT) support, Jito Block Engine anti-sandwich tips, and post-unwrap Token -> SOL emergency exits.
4. Atomic 20 bps Partner Referral Split (referrerPubkey / ?ref=): Bot developers, MCP hosts, and Telegram group admins earn 20 bps (0.20%) in native SOL atomically inside every routed swap (45 bps protocol / 20 bps partner — zero extra user cost, automatic rent-exemption guard).

---

1. Connect AI Agents via MCP (Claude, Cursor, Windsurf, Cline, Codex, Smithery, Glama)

Option A (Recommended): Zero-Install Remote HTTP MCP (0 npm / 0 Local Node)

Add directly to Cursor (.cursor/mcp.json), Claude, Windsurf, or any Streamable-HTTP MCP client:

{
  "mcpServers": {
    "solguard": {
      "url": "https://solguard-protocol.pages.dev/mcp"
    }
  }
}

Option B: Local stdio via GitHub npx (With Optional 20 bps Partner Wallet)

{
  "mcpServers": {
    "solguard": {
      "command": "npx",
      "args": ["-y", "github:Tradelord223/solguard-mcp"],
      "env": {
        "SOLGUARD_REFERRER_PUBKEY": "YOUR_SOLANA_WALLET_PUBKEY"
      }
    }
  }
}

Note for npm 12+: Pass "args": ["--allow-git=all", "-y", "github:Tradelord223/solguard-mcp"]. Verify live from any terminal: npx --allow-git=all -y github:Tradelord223/solguard-mcp --self-test

MCP Tools Exposed

MCP Tool	Inputs	Purpose
solana_token_forensic_audit	mint	Live Mainnet inspection of authorities, Token-2022 hooks (permanentDelegate, transferHook, pausableConfig), DEX liquidity & 1.0 SOL round-trip impact in bps.
build_jito_safe_swap	userPublicKey, outputMint, amountSol, slippageBps?, referrerPubkey?	Verifies mint safety, then builds an unsigned v0 SOL -> Token buy packet with Jito tip + optional 20 bps partner referral split.
build_jito_safe_exit	userPublicKey, inputMint, sellPct?, amountRaw?, referrerPubkey?	Builds an unsigned v0 Token -> SOL post-unwrap exit packet paying fees out of unwrapped SOL sale proceeds.

---

2. Earn 20 bps Partner Referral Revenue (?ref= & referrerPubkey)

External bot operators, AI-agent builders, Blink creators, and Telegram channel owners earn 20 bps (30.7% revenue share) paid atomically in native SOL on every Buy and Safe-Exit:

• Shareable Web / Blink / Phantom Mobile Link:

  https://solguard-protocol.pages.dev/check/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263?ref=YOUR_SOL_WALLET
  

• SDK / API Integration (referrerPubkey):

  import { SolGuardClient } from "solguard-mcp";
  
  const guard = new SolGuardClient({
    referrerPubkey: "YOUR_SOL_WALLET", // Earns 20 bps atomically on every swap & exit!
  });
  
  const built = await guard.buildSafeSwap({
    userPublicKey: traderPubkey,
    outputMint: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    amountSol: 0.5,
    slippageBps: 100,
  });
  

---

3. Viral Telegram Inline Mode (@Solguardscannerbot <mint>) & Live PNG Scorecards

Type @Solguardscannerbot <mint> inside any Solana Telegram group or DM to drop an instant forensic card with 1-Tap Mobile Phantom / Solflare universal deep-links and emergency ?side=sell Safe-Exit buttons — or follow automated 15-minute Mainnet radar alerts in @SolanaGuardLive.

Every token check also generates a live 1200x630 PNG social preview card for X/Twitter, Telegram, and Discord:

---

4. 1-Line Fix for quote-api.jup.ag/v6 ENOTFOUND & Full JS/TS SDK

// Drop-in replacement for sunset @jup-ag/api:
import { createJupiterApiClient, solguard } from "solguard-mcp";

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

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)

---

5. Live Ecosystem Links

• 🌐 Web Security Terminal & Developer Hub: https://solguard-protocol.pages.dev • /developers
• 📢 24/7 Live Alerts Channel: https://t.me/SolanaGuardLive (@SolanaGuardLive)
• 🤖 Telegram Inline & DM Scanner Bot: https://t.me/Solguardscannerbot?start=alerts (@Solguardscannerbot <mint>)
• Companion Open-Source Kits:
  • Tradelord223/eliza-plugin-solguard — Autonomous Trading Bot Plugin (ElizaOS, Solana Agent Kit, LangChain) + Pure-JS Token-2022 TLV Decoder
  • Tradelord223/jupiter-v6-dns-fix — Node.js & Python quote-api.jup.ag ENOTFOUND drop-in rescue SDK
  • Tradelord223/solana-blinks-jito-starter — Solana Actions v2.2 (Dialect Blinks) + Token-2022 Guard + Jito Starter Kit

License

MIT © SolGuard Protocol