Metadata-Version: 2.5
Name: rugsight
Version: 0.1.0
Summary: Tiny client for Rugsight: Solana token rug-risk scores (free) and full reports (0.03 USDC per call via x402). Standard library only.
Project-URL: Homepage, https://rugsight.rugsight.workers.dev
Project-URL: Source, https://github.com/rugsightapp/rugsight/tree/main/packages/python
Project-URL: Issues, https://github.com/rugsightapp/rugsight/issues
Author-email: Rugsight <yunare-qwerng+rugsight@mail.grokbot.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agent,crypto,mcp,risk,rug-check,rug-pull,security,solana,token,x402
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# rugsight (Python)

A tiny, standard-library-only client for [Rugsight](https://rugsight.rugsight.workers.dev), a rug-risk checker for Solana tokens (SPL and Token-2022).

```bash
pip install rugsight
```

```python
from rugsight import Rugsight, PaymentRequiredError

rs = Rugsight()
s = rs.get_score("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263")  # BONK, free
print(s["score"], s["grade"], s["verdict"], [f["code"] for f in s["flags"]])

feed = rs.get_new_tokens()  # free: recently launched tokens, checked every 30 minutes

try:
    report = rs.get_report(mint)  # full report: 0.03 USDC per call via x402 on Solana
except PaymentRequiredError as e:
    req = e.payment_required  # x402 v2 PaymentRequired; sign it with any x402 client, then:
    # report = rs.get_report(mint, payment_header={"PAYMENT-SIGNATURE": signed_header})
```

- No API key and no signup. Payments are crypto only (USDC on Solana via x402, settled by the PayAI facilitator).
- MCP server: `https://rugsight.rugsight.workers.dev/mcp`. Framework examples are at https://github.com/rugsightapp/rugsight/tree/main/integrations

Rugsight runs automated technical analysis on public on-chain data. **This is not financial advice.** MIT license.
