Skip to main content
Glama
Solana Rent & Rug Shield MCP Gateway

Solana Rent & Rug Shield MCP Gateway

by sonnyman2014

Solana Rent & Rug Shield MCP Gateway (@rentandrugshield/mcp-server & solana-rug-shield)

Production Model Context Protocol (MCP) security gateway and x402 Solana machine-payment toolkit powered by https://rentandrugshield.com. Built for autonomous Solana AI trading agents, IDE copilots, and DeFi wallets requiring <120ms pre-buy token rug protection, Layer 9 Inner CPI transaction drainer simulation, and read-only unclaimed ATA SOL rent discovery.

  • Registry Manifests Included: server.json (Official MCP Registry), smithery.yaml (Smithery.ai), glama.json (Glama.ai), Dockerfile (Node >=20 multi-stage container), and registry/mcp_so_submission.json (MCP.so).

Distribution Packages

  • TypeScript / NPX MCP Server: @rentandrugshield/mcp-server (npx -y @rentandrugshield/mcp-server or binary rentandrugshield-mcp)

  • Python / PyPI SDK & MCP Server: solana-rug-shield (pip install solana-rug-shield with built-in MCP stdio server mode and sync/async Python SDK)

  • Production Upstream Gateway: https://rentandrugshield.com

  • Official MCP Registry Namespace: io.github.sonnyman2014/solana-rent-rug-shield-mcp and com.rentandrugshield/mcp-server

Related MCP server: obol

Zero-Install Remote Streamable HTTP MCP (https://rentandrugshield.com/mcp)

Connect any Streamable HTTP MCP client (Claude, Cursor, Windsurf, Cline, OpenAI Agents, LangGraph) directly with zero local installation:

{
  "mcpServers": {
    "rentandrugshield": {
      "type": "streamable-http",
      "url": "https://rentandrugshield.com/mcp"
    }
  }
}
  • Zero-Install Streamable HTTP Endpoint: https://rentandrugshield.com/mcp (MCP 2025-03-26 and 2024-11-05)

  • Discovery Manifests: https://rentandrugshield.com/.well-known/mcp.json and https://rentandrugshield.com/.well-known/x402

  • Solana x402 V1 & V2 Auto-Pay: 10 free pings per X-Agent-Id, then 0.026 SOL ($1.99 Unlimited Pro Pass) or 0.0003 SOL (~$0.02 single scan) to 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1 via PAYMENT-SIGNATURE or X-Payment.

Quick Start Commands

Launch via NPX (@rentandrugshield/mcp-server)

npx -y @rentandrugshield/mcp-server

Install and Launch via PyPI (solana-rug-shield)

pip install solana-rug-shield
solana-rug-shield --mcp-stdio

Direct Python SDK Usage (solana-rug-shield)

from solana_rug_shield import RugShieldClient

client = RugShieldClient(api_url="https://rentandrugshield.com")

audit = client.audit_solana_token_10_layer(
    mint="So11111111111111111111111111111111111111112"
)
sim = client.simulate_solana_tx_drain(transaction="AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED")
rent = client.scan_wallet_unclaimed_sol(
    wallet="89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1",
    include_token_2022=True,
)

Direct GitHub Release v1.0.0 Install (Zero Registry Wait)

npx -y https://github.com/sonnyman2014/solana-rent-rug-shield-mcp/releases/download/v1.0.0/rentandrugshield-mcp-server-1.0.0.tgz
pip install https://github.com/sonnyman2014/solana-rent-rug-shield-mcp/releases/download/v1.0.0/solana_rug_shield-1.0.0-py3-none-any.whl

Core Solana Security Tools (3 MCP Tools)

1. audit_solana_token_10_layer (<120ms Pre-Buy Token Safety Gate)

  • Purpose: High-speed <120ms warm-socket pre-buy anti-rug safety gate powered by persistent HTTP keep-alive connection pooling for autonomous sniper bots, DeFi execution agents, and trading terminals.

  • 10 Security Layers Evaluated: Mint authority status, freeze authority status, Token-2022 permanent delegate hooks, Token-2022 transfer fee mutations, non-transferable / close-authority traps, liquidity pool lock and burn ratio, top holder cluster concentration, metadata mutability, creator rug history, and live sellability verification (returning a 0 to 100 safety score plus actionable risk flags).

  • Inputs: mint (required base58 mint address), optional pool_address, wallet, payment_signature, pro_pass_token.

2. simulate_solana_tx_drain (Layer 9 Inner CPI Drainer Check)

  • Purpose: Pre-signing transaction firewall that simulates serialized Solana transactions (base64 or base58) and inspects full Layer 9 Inner Cross-Program Invocations (Inner CPI) before an agent or user wallet signs.

  • Threats Blocked: Stealth SetAuthority account ownership takeovers, hidden SPL / Token-2022 Approve delegate drains, multi-hop wrapper program SOL sweeps, and malicious CPI callback hooks disguised inside benign swap instructions.

  • Inputs: transaction (required serialized transaction), optional wallet, encoding (base64 or base58), payment_signature, pro_pass_token.

3. scan_wallet_unclaimed_sol (Read-Only ATA Rent Check)

  • Purpose: Zero-custody, strictly read-only Mainnet wallet scanner that discovers reclaimable rent-exempt SOL locked in empty SPL (Tokenkeg) and Token-2022 Associated Token Accounts (ATAs), dust accounts, and PumpSwap / Pump volume accumulator PDAs.

  • Safety Guarantee: Requires only a public base58 wallet address; never requests private keys for scanning and reports exact account counts plus net reclaimable SOL (95% user payout structure on https://rentandrugshield.com).

  • Inputs: wallet (required base58 wallet address), optional include_token_2022 (boolean, default true), payment_signature, pro_pass_token.

10 Free Pings + Native Solana x402 Machine Auto-Pay

Every agent and developer session connecting to https://rentandrugshield.com receives 10 free pings out of the box with zero API keys, zero credit cards, and zero setup.

When the 11th unpaid request triggers HTTP 402 Payment Required, the gateway returns standard Payment-Required and X-Payment-Required base64 JSON x402 v1 challenges targeting verified Solana Mainnet treasury 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1 with two instant machine-payable tiers:

  • Option A (option_a_pro_pass / Unlimited Pro Pass): 0.026 SOL (26,000,000 lamports, $1.99 Unlimited Pro Pass). Issues a signed X-Pro-Pass-Token cached automatically by @rentandrugshield/mcp-server and solana-rug-shield so all subsequent tool calls resolve 200 OK with zero per-call settlement overhead.

  • Option B (option_b_single_scan / Instant Single Scan): 0.0003 SOL (300,000 lamports, $0.02 single scan). Unlocks one immediate verified scan per unique Solana Mainnet transaction signature enforced by strict on-chain anti-replay verification.

  • Autonomous Agent Settlement: When SOLANA_PRIVATE_KEY (or X402_SOLANA_PRIVATE_KEY) is configured in the MCP environment, both @rentandrugshield/mcp-server and solana-rug-shield automatically build and broadcast the exact SOL transfer to 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1, attach the base64 X-Payment payload plus X-Solana-Tx-Signature, and retry the tool call transparently in a single turn.

  • Keyless / Manual Settlement: When no private key is configured, the MCP tool returns the structured x402 challenge instructions so human operators or external signers can pass payment_signature or pro_pass_token directly on retry.

Environment Variables

  • RENTSHIELD_API_URL: Upstream gateway base URL (defaults to https://rentandrugshield.com).

  • SOLANA_PRIVATE_KEY: Optional base58 string or JSON byte array [...] for automatic x402 HTTP 402 SOL settlement.

  • X402_SOLANA_PRIVATE_KEY: Optional dedicated alias for SOLANA_PRIVATE_KEY.

  • X402_OPTION: Select option_a_pro_pass (0.026 SOL $1.99 Unlimited Pro Pass, default) or option_b_single_scan (0.0003 SOL $0.02 single scan).

  • RENTSHIELD_PRO_PASS_TOKEN: Optional pre-provisioned X-Pro-Pass-Token for instant unlimited Pro Pass access.

  • SOLANA_RPC_URL: Solana Mainnet RPC URL used when broadcasting automatic x402 transfers (defaults to https://api.mainnet-beta.solana.com).

Client and Agent Framework Configurations

1. Claude Desktop (claude_desktop_config.json)

Option 1A: Node / NPX (@rentandrugshield/mcp-server)

{
  "mcpServers": {
    "rentandrugshield": {
      "command": "npx",
      "args": ["-y", "@rentandrugshield/mcp-server"],
      "env": {
        "RENTSHIELD_API_URL": "https://rentandrugshield.com",
        "X402_OPTION": "option_a_pro_pass"
      }
    }
  }
}

Option 1B: Python / PyPI (solana-rug-shield)

{
  "mcpServers": {
    "rentandrugshield": {
      "command": "uvx",
      "args": ["solana-rug-shield", "--mcp-stdio"],
      "env": {
        "RENTSHIELD_API_URL": "https://rentandrugshield.com",
        "X402_OPTION": "option_a_pro_pass"
      }
    }
  }
}

2. Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "rentandrugshield": {
      "command": "npx",
      "args": ["-y", "@rentandrugshield/mcp-server"],
      "env": {
        "RENTSHIELD_API_URL": "https://rentandrugshield.com",
        "SOLANA_PRIVATE_KEY": "YOUR_OPTIONAL_AGENT_BASE58_KEY",
        "X402_OPTION": "option_a_pro_pass"
      }
    }
  }
}

3. Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "rentandrugshield": {
      "command": "npx",
      "args": ["-y", "@rentandrugshield/mcp-server"],
      "env": {
        "RENTSHIELD_API_URL": "https://rentandrugshield.com",
        "X402_OPTION": "option_a_pro_pass"
      }
    }
  }
}

4. Cline (cline_mcp_settings.json)

{
  "mcpServers": {
    "rentandrugshield": {
      "command": "npx",
      "args": ["-y", "@rentandrugshield/mcp-server"],
      "disabled": false,
      "autoApprove": [
        "audit_solana_token_10_layer",
        "simulate_solana_tx_drain",
        "scan_wallet_unclaimed_sol"
      ],
      "env": {
        "RENTSHIELD_API_URL": "https://rentandrugshield.com",
        "X402_OPTION": "option_b_single_scan"
      }
    }
  }
}

5. OpenAI Agents SDK (openai-agents)

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStdio


async def main() -> None:
    async with MCPServerStdio(
        name="RentAndRugShield",
        params={
            "command": "npx",
            "args": ["-y", "@rentandrugshield/mcp-server"],
            "env": {
                "RENTSHIELD_API_URL": "https://rentandrugshield.com",
                "X402_OPTION": "option_a_pro_pass",
            },
        },
    ) as rug_shield_mcp:
        agent = Agent(
            name="SolanaExecutionGuard",
            instructions=(
                "Always call audit_solana_token_10_layer before any token swap and "
                "simulate_solana_tx_drain before signing any serialized transaction."
            ),
            mcp_servers=[rug_shield_mcp],
        )
        result = await Runner.run(
            agent,
            "Audit Solana mint So11111111111111111111111111111111111111112 and report safety score.",
        )
        print(result.final_output)


if __name__ == "__main__":
    asyncio.run(main())

6. LangChain (langchain-mcp-adapters & solana-rug-shield)

import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent


async def run_guard() -> None:
    client = MultiServerMCPClient(
        {
            "rentandrugshield": {
                "command": "npx",
                "args": ["-y", "@rentandrugshield/mcp-server"],
                "transport": "stdio",
                "env": {
                    "RENTSHIELD_API_URL": "https://rentandrugshield.com",
                    "X402_OPTION": "option_a_pro_pass",
                },
            }
        }
    )
    tools = await client.get_tools()
    agent = create_react_agent("openai:gpt-4o", tools)
    response = await agent.ainvoke(
        {
            "messages": [
                {
                    "role": "user",
                    "content": "Scan wallet 89Sv5FvnMNRid1bn8y2Ti1vJPSxWxgiW9GSLsPpBnKK1 for unclaimed ATA SOL rent.",
                }
            ]
        }
    )
    print(response["messages"][-1].content)


if __name__ == "__main__":
    asyncio.run(run_guard())

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
      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
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to access Solana wallet analytics, token data, and DeFi tools via pay-per-request USDC micropayments using the x402 protocol, without API keys or subscriptions.
      13
      69 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI trading agents machine-readable trust and risk verdicts on Solana by checking whether a wallet's realized PnL makes it worth copying, where its funds came from, whether a token is structurally safe, and what a given trade size would really cost in slippage. Exposes these four checks as MCP tools callable against a hosted x402 pay-per-call API, so agents can hard-stop bad trades without RPC keys, signup, or local setup.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables agents to run pre-signature security checks: identifying who can replace a Solana program's code or control an EVM contract's upgrades, surfacing dependency advisories for lockfiles, scanning public repos before release, and setting 30-day signed-webhook alerts on changes. Calls are paid per use in USDC over x402 from a wallet with per-call caps and a session budget.
      8
      66 npm
      MIT