Pnllabs MCP Server

PnL Labs — MCP server & x402 API

Trust & risk verdicts for AI trading agents on Solana. Proof of real PnL, not peak scores. Pay-per-call via x402 (USDC on Solana) — no signup, no API key, no account.

🌐 pnllabs.com · 🔌 https://api.pnllabs.com · 🐦 @pnllabs

---

Why

Every "smart money" score you've seen ranks wallets by peak or paper gains. Peaks lie. A wallet can 100x on paper, dump into no liquidity, and walk away red — while its score still says genius. We audited 30 tracked "smart money" wallets and half of them are genuinely losing money on-chain.

PnL Labs recomputes what actually hit the wallet — realized SOL, in vs out — and returns a conservative, machine-readable verdict. When the numbers can't be reconstructed reliably, it says UNVERIFIABLE instead of guessing.

The four checks

Every response carries a stable verdict enum, machine-readable reasons (code + message), confidence, flags, and schema_version. Built to be parsed by agents, not read by humans. Interactive docs: https://api.pnllabs.com/docs.

Quick example

curl https://api.pnllabs.com/check/wallet/57hECCDVNmP7jCY6XX6FxP31DQuKiwQhv2g3nxGPLPmV

{
  "schema_version": 1,
  "verdict": "UNTRUSTED",
  "confidence": "high",
  "trust": 15,
  "reasons": [
    { "code": "NEGATIVE_REALIZED_PNL", "message": "Genuinely NEGATIVE: -47.1 SOL net realized" },
    { "code": "LOW_WIN_RATE", "message": "Only 27% of coins were profitable" }
  ]
}

MCP server

This repo ships an MCP server exposing the four checks as tools (check_wallet_trust, check_wallet_forensics, check_token_safety, check_trade_cost). It calls the hosted API — no RPC keys or local setup needed.

Add to an MCP client (e.g. Claude Desktop / Claude Code):

{
  "mcpServers": {
    "pnllabs": {
      "command": "python3",
      "args": ["/path/to/pnllabs_mcp.py"]
    }
  }
}

Runs on the Python standard library — no dependencies for the free/beta tier.

Payment (x402)

Calls are priced per request and paid in USDC on Solana via the x402 protocol (HTTP 402). Your agent pays a few cents, gets an on-chain receipt — no accounts, no keys stored anywhere. Prices: wallet 0.10, funder 0.05, token/trade 0.02 USDC. Any x402-capable client (or the official x402 SDKs) can pay automatically.

Honest scope

• Wallet trust & forensics are the core edge — realized-PnL truth and funding origin, which peak-based scores and EVM-only tools don't provide on Solana.
• Token safety flags structural red flags with zero noise. Behavioral rugs (an operator selling into his own hype) are invisible to all structural checkers — for those, check the wallets involved.
• We sell risk/trust verdicts, not alpha. Never "when to buy."

License

MIT — see LICENSE.