{
  "markdown": "# PnL Labs — MCP server & x402 API\n\n**Trust & risk verdicts for AI trading agents on Solana.** Proof of *real* PnL,\nnot peak scores. Pay-per-call via [x402](https://www.x402.org) (USDC on Solana) —\nno signup, no API key, no account.\n\n🌐 **[pnllabs.com](https://pnllabs.com)** · 🔌 **`https://api.pnllabs.com`** · 🐦 **[@pnllabs](https://x.com/pnllabs)**\n\n---\n\n## Connect in 10 seconds (hosted MCP — no install)\n\nThe server is hosted. Add it to any MCP-capable assistant with one URL:\n\n```\nhttps://api.pnllabs.com/mcp\n```\n\n- **Claude** (all plans): Settings → Connectors → *Add custom connector*\n- **Grok**: [grok.com/connectors](https://grok.com/connectors) → *Custom*\n- **ChatGPT / Gemini**: custom MCP connector → same URL\n- Also listed in the [official MCP Registry](https://registry.modelcontextprotocol.io) (`io.github.PnLlabs/pnllabs`) and on Smithery.\n\nFree tier per IP/day — when it runs out, the tools reply with structured\nx402 payment instructions (pay-per-call, USDC on Solana).\n\n---\n\n## Why\n\nEvery \"smart money\" score you've seen ranks wallets by **peak or paper gains**.\nPeaks lie. A wallet can 100x on paper, dump into no liquidity, and walk away red —\nwhile its score still says genius. We audited 30 tracked \"smart money\" wallets and\n**half of them are genuinely losing money on-chain.**\n\nPnL Labs recomputes what actually hit the wallet — realized SOL, in vs out — and\nreturns a conservative, machine-readable verdict. When the numbers can't be\nreconstructed reliably, it says `UNVERIFIABLE` instead of guessing.\n\n## The four checks\n\n| Endpoint | Question | Verdicts |\n|---|---|---|\n| `GET /check/wallet/{address}` | Is this wallet worth copying? (real realized PnL) | `TRUSTED` · `NEUTRAL` · `UNTRUSTED` · `INSUFFICIENT` · `UNVERIFIABLE` |\n| `GET /check/funder/{address}` | Where did this wallet's money come from? (funding origin / cluster links) | `CEX_FUNDED` · `WALLET_FUNDED` · `UNKNOWN_ORIGIN` · `UNVERIFIABLE_ORIGIN` |\n| `GET /check/token/{mint}` | Is this token structurally safe? | `LOW_RISK` · `ELEVATED` · `HIGH_RISK` · `CRITICAL` · `UNKNOWN` |\n| `GET /check/trade/{mint}?size_sol=1` | What will this trade really cost? (real slippage) | `ACCEPTABLE_COST` · `ELEVATED_COST` · `HIGH_COST` · `UNTRADEABLE` · `NO_POOL` |\n\nEvery response carries a stable `verdict` enum, machine-readable `reasons` (code +\nmessage), `confidence`, `flags`, and `schema_version`. Built to be parsed by agents,\nnot read by humans. Interactive docs: `https://api.pnllabs.com/docs`.\n\n## Quick example\n\n```bash\ncurl https://api.pnllabs.com/check/wallet/57hECCDVNmP7jCY6XX6FxP31DQuKiwQhv2g3nxGPLPmV\n```\n\n```json\n{\n  \"schema_version\": 1,\n  \"verdict\": \"UNTRUSTED\",\n  \"confidence\": \"high\",\n  \"trust\": 15,\n  \"reasons\": [\n    { \"code\": \"NEGATIVE_REALIZED_PNL\", \"message\": \"Genuinely NEGATIVE: -47.1 SOL net realized\" },\n    { \"code\": \"LOW_WIN_RATE\", \"message\": \"Only 27% of coins were profitable\" }\n  ]\n}\n```\n\n## MCP server\n\nThis repo ships an [MCP](https://modelcontextprotocol.io) server exposing the four\nchecks as tools (`check_wallet_trust`, `check_wallet_forensics`, `check_token_safety`,\n`check_trade_cost`). It calls the hosted API — no RPC keys or local setup needed.\n\n**Add to an MCP client** (e.g. Claude Desktop / Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"pnllabs\": {\n      \"command\": \"python3\",\n      \"args\": [\"/path/to/pnllabs_mcp.py\"]\n    }\n  }\n}\n```\n\nRuns on the Python standard library — no dependencies for the free/beta tier.\n\n## Payment (x402)\n\nCalls are priced per request and paid in USDC on Solana via the x402 protocol\n(HTTP 402). Your agent pays a few cents, gets an on-chain receipt — no accounts,\nno keys stored anywhere. Prices: wallet `0.10`, funder `0.05`, token/trade `0.02` USDC.\nAny x402-capable client (or the official x402 SDKs) can pay automatically.\n\n## Honest scope\n\n- **Wallet trust & forensics** are the core edge — realized-PnL truth and funding\n  origin, which peak-based scores and EVM-only tools don't provide on Solana.\n- **Token safety** flags structural red flags with zero noise. Behavioral rugs\n  (an operator selling into his own hype) are invisible to *all* structural\n  checkers — for those, check the wallets involved.\n- We sell **risk/trust verdicts, not alpha.** Never \"when to buy.\"\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 4285,
  "sha": "c105b7bbec0c7c6b0d1af7b560ada36099e8907f52ddb0f0a0f7e3c724783588",
  "repo_slug": "pnllabs/pnllabs-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pnllabs_pnllabs_9f00a7c9/readme"
}