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

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

SolGuard MCP & Safe-Swap SDK