SolSentry

npm version license

RugCheck tells you a fire is burning. SolSentry tells you who lit it.

SolSentry packages its public operator-risk intelligence surface as an MCP server, a TypeScript SDK, and a skills bundle. All interfaces use the live REST API at https://api.solsentry.app.

Live references

Precision is auditable per-mint at /v1/predictions/{mint} (live). Pull any current system numbers from the live API rather than this README — never cite a hardcoded accuracy/precision figure or operator-level aggregate as a standing fact.

• API stats: https://api.solsentry.app/v1/stats
• NPM: https://www.npmjs.com/package/@solsentry/mcp
• GitHub org: https://github.com/solsentry

Interfaces

Surface	Use it when	Entry
MCP server	AI agents (Claude Desktop, Cursor, Claude Code, any MCP client)	npx @solsentry/mcp
TypeScript SDK	TS backends, bots, wallets, dApps that don't speak MCP	import { SolSentryClient } from "@solsentry/mcp/client"
Skills bundle	Claude Code / Cursor with the Agent Skills spec	npx skills add @solsentry/mcp

All three call the public REST API at api.solsentry.app. No API key required for read endpoints.

Numbers drift daily as predictions resolve — verify live: curl https://api.solsentry.app/v1/stats

What's in this repo

solsentry-mcp/
├── src/                            ← TypeScript source (MCP server + SDK)
├── skills/
│   └── solsentry-postdeploy/       ← 1 skill, 6 references (progressive disclosure)
│       ├── SKILL.md                  orchestrator: when to load each reference
│       └── references/
│           ├── threat-intel.md     · generic risk lookup
│           ├── counterparty.md     · pre-CPI counterparty check
│           ├── monitor.md          · post-deploy program monitoring
│           ├── forensics.md        · post-incident drain trace
│           ├── token-launch.md     · pre-launch readiness for your own token
│           └── cluster-graph.md    · operator/bot network exploration
└── docs/                           ← public reference docs
    ├── risk-scoring.md             · scoring methodology + thresholds
    ├── flags.md                    · canonical flag glossary
    ├── openapi.yaml                · machine-readable REST spec
    └── x402-example.md             · paid endpoint integration example

SolSentry monitors Solana mainnet continuously and tracks serial rug pull operators, bot clusters, and malicious token launches. The data is refreshed every 30 seconds and available to any client that speaks MCP or plain HTTP.

Quick start

npx -y @solsentry/mcp

Claude Desktop

{
  "mcpServers": {
    "solsentry": {
      "command": "npx",
      "args": ["-y", "@solsentry/mcp"]
    }
  }
}

Cursor / Claude Code

{
  "mcpServers": {
    "solsentry": {
      "command": "npx",
      "args": ["-y", "@solsentry/mcp"]
    }
  }
}

Tools

Tool	Purpose
check_operator	Risk profile of a wallet as a token deployer
check_token	Risk profile of a token mint
get_top_operators	Leaderboard of serial ruggers
get_network_stats	System-wide public metrics
explain_risk	Plain-language summary for a wallet or mint

TypeScript SDK

import { SolSentryClient } from "@solsentry/mcp/client";

const client = new SolSentryClient();
const stats = await client.get("/v1/stats");
console.log(stats);

REST API

curl https://api.solsentry.app/v1/stats
curl https://api.solsentry.app/v1/operator/<wallet-address>
curl https://api.solsentry.app/v1/top-operators?limit=5

Configuration

Environment variable	Default	Purpose
SOLSENTRY_API_URL	https://api.solsentry.app	API endpoint
SOLSENTRY_API_KEY	—	Bearer token for authenticated endpoints

Notes

• Public quality claim: precision is auditable per-mint at /v1/predictions/{mint} (live) — re-verify on the day; never ship a hardcoded precision number.

Requirements

• Node.js >= 18

License

MIT

Links + Contact

• Site: solsentry.app
• X (project): @solsentryai
• Telegram: t.me/solsentryai
• GitHub: github.com/solsentry
• Email: [email protected]
• Built by: Crash Diniz · @crashdiniz