{
  "markdown": "# OpenPulsechain\n\n[![smithery badge](https://smithery.ai/badge/openpulsechain/mcp-server)](https://smithery.ai/servers/openpulsechain/mcp-server)\n\nOpen-source analytics platform for [PulseChain](https://pulsechain.com).\n\n**Live:** [openpulsechain.com](https://www.openpulsechain.com) · **Dune:** [Bridge Analytics](https://dune.com/openpulsechain/pulsechain-bridge-analytics)\n\n> Not affiliated with PulseChain, PulseX, or any related entity. Data is for informational purposes only — not financial advice.\n\n---\n\n## What's included\n\n| Module | Description |\n|--------|-------------|\n| **Dashboard** | 16-page web app: Overview, DEX, Tokens, Bridge, Whales, Intelligence, Safety, Alerts, Smart Money, Leagues, Heart Law, Wallet Profiles, Token Safety, MCP/API, Privacy |\n| **Token Safety API** | FastAPI with 25 public endpoints: safety scores, scam radar, deployer reputation, smart money, wallet analysis, leagues, bridge stats, funding trees |\n| **REST API** | FastAPI with 12 endpoints: tokens, prices, history, pairs, market overview, safety proxies |\n| **MCP Server** | Model Context Protocol server with 20 tools for AI assistants |\n| **Chrome Extension** | Token safety scores, transaction guard, portfolio tracker, scam alerts |\n| **Indexers** | 23 Python cron jobs collecting on-chain data every 5-15 min |\n| **Dune** | 9 SQL queries + 20 visualizations for bridge analytics (Ethereum-side) |\n\n## Features\n\n### Analytics Dashboard\n- **Overview** — PLS price, chain TVL, gas estimates, token prices table\n- **DEX Analytics** — PulseX daily volume, liquidity, top 30 trading pairs\n- **Token Explorer** — 2500+ browsable tokens with pagination, search, price history charts\n- **Bridge Monitor** — OmniBridge + Hyperlane: daily flows, cumulative net flow, whale alerts, TVL by token\n- **Whale Tracker** — Top holders, cross-token analysis, funding clusters, connection graph\n- **Leagues** — Holder tier rankings for PLS, PLSX, HEX, INC, updated every 6 hours\n- **Heart Law** — Educational AMM price simulator for PulseX pools\n\n### Security & Intelligence\n- **Token Safety Scanner** — Composite score (0-100, grade A-F) based on honeypot detection, contract analysis, LP health, holder concentration, token age\n- **Scam Radar** — Automated alerts for LP removals and whale dumps, scanning every 30 minutes\n- **Deployer Reputation** — Serial rugger detection: analyzes deployer's token history, dead token ratio\n- **Smart Money Tracker** — Large swaps on PulseX, top wallets by volume, auto-refresh every 60s\n- **Wallet Profiler** — Token holdings + swap activity for any address\n- **Market Intelligence** — AI-analyzed Twitter sentiment, risk conclusions, action detection\n\n### Chrome Extension\n- **Transaction Guard** — Intercepts swaps on PulseX, 9mm, Piteas and warns about risky tokens before signing\n- **Safety Scanner** — Browse all analyzed tokens with safety scores, grades, and sub-score details\n- **Portfolio Tracker** — Track wallet balances with sparkline charts\n- **Scam Alerts** — Real-time notifications for critical scam detections\n\n## Data\n\n- **2,500+ tokens** discovered from PulseX Subgraph\n- **463K+ price records** (daily, since May 2023)\n- **231K+ bridge transfers** (OmniBridge + Hyperlane)\n- **100% sovereign** token prices from PulseX `derivedUSD` — no CoinGecko dependency for PulseChain tokens\n\n## Architecture\n\n```\nPulseX Subgraph ──┐\nDefiLlama API ────┤\nPulseChain RPC ───┤──> Python Indexers ──> PostgreSQL (RLS)\nBlockscout API ───┘                            │\n                                     ┌─────────┼──────────┐\n                                     │         │          │\n                                React SPA  REST API   Safety API\n                                     │                    │\n                                Dashboard         safety.openpulsechain.com\n                              16 pages + MCP      25 public endpoints\n                                     │\n                             Chrome Extension\n```\n\n## Project Structure\n\n```\n/\n  frontend/              # React dashboard (16 pages)\n  api/                   # REST API FastAPI (tokens, prices, pairs)\n  token_safety/          # Safety API FastAPI (scores, scam radar, deployer, smart money, leagues)\n  indexers/              # 23 Python cron jobs (on-chain data collection)\n  live_cache/            # Real-time token pool cache (DexScreener)\n  mcp-server/            # MCP server for AI assistants (20 tools)\n  extension/             # Chrome browser extension\n  dune/                  # SQL queries for Dune Analytics\n  docs/                  # Documentation\n```\n\n## Getting started\n\n```bash\ngit clone https://github.com/openpulsechain/openpulsechain.git\ncd openpulsechain\n```\n\n| Module | Setup |\n|--------|-------|\n| `frontend/` | `npm install && npm run dev` |\n| `indexers/` | `pip install -r requirements.txt` + `.env` config |\n| `api/` | `pip install -r requirements.txt && uvicorn main:app` |\n| `token_safety/` | `pip install -r requirements.txt && uvicorn main:app` |\n| `mcp-server/` | `npm install && npm run build` |\n| `extension/` | `npm install && npm run build` → load `dist/` in Chrome |\n\n## Data sources\n\n| Data | Source | Access |\n|------|--------|--------|\n| Token prices (PulseChain) | PulseX Subgraph `derivedUSD` | Public |\n| TVL, DEX volume | DefiLlama API | Public |\n| Gas price, blocks | PulseChain RPC | Public |\n| Bridge events (ETH-side) | Dune Analytics | Public (2500 credits/mo) |\n| Bridge events (PLS-side) | PulseChain OmniBridge Subgraph | Public |\n| Hyperlane transfers | Hyperlane Explorer API | Public |\n| Contract analysis | PulseChain Scan API (Blockscout v2) | Public |\n| Honeypot detection | FeeChecker contract (on-chain simulation) | On-chain |\n| Token logos | PulseX CDN, Piteas GitHub, DexScreener | Public |\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 5804,
  "sha": "d03f2b5b0eb44140691db2515e1ceb9fa0d1601fb766b5dc7398f0bb042e21cf",
  "repo_slug": "openpulsechain/public",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_openpulsechain_analytics_1eb9eb8f/readme"
}