# OpenPulsechain

PulseChain on-chain analytics for AI agents. Token safety scores (0-100, A-F), honeypot detection, whale tracking, smart money feed, scam alerts, DEX volume, bridge stats, holder leagues. 11 free + 9…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add openpulsechain/mcp-server

# Browse available tools
npx -y smithery tool list openpulsechain/mcp-server

# Get full schema for a tool
npx -y smithery tool get openpulsechain/mcp-server get-token-price

# Call a tool
npx -y smithery tool call openpulsechain/mcp-server get-token-price '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--openpulsechain.run.tools`

## Tools (28)

- `get-token-price` — Get current price, 24h change, volume, and market cap for a PulseChain token.
- `get-token-info` — Get full details for a PulseChain token: name, symbol, decimals, liquidity, volume, holder count.
- `get-token-history` — Get historical price data (OHLCV) for a PulseChain token. Limited to 30 days without API key; Pro unlocks full history.
- `get-top-tokens` — List top PulseChain tokens sorted by volume, liquidity, or symbol.
- `get-top-pairs` — List top PulseX DEX trading pairs by volume.
- `get-market-overview` — Get PulseChain network overview: TVL, 24h volume, active tokens, top gainers/losers.
- `get-token-safety` — Analyze a token for scam indicators: honeypot detection, buy/sell tax, ownership, liquidity score (0-100, A-F grade).
- `get-token-liquidity` — Get detailed liquidity breakdown for a token: all DEX pairs, volumes, and reserves.
- `check-address-risk` — [PRO] Check if a wallet/contract address is flagged for AML risk, known exploits, phishing, or sanctions (OFAC). Requir…
- `get-deployer-reputation` — [PRO] Get reputation score for a token deployer: how many tokens deployed, how many died (rug pattern detection). Requi…
- `get-scam-alerts` — [PRO] Get real-time scam radar alerts: honeypots, LP removals (rug pulls), whale dumps. Requires OPENPULSECHAIN_API_KEY.
- `get-smart-money-feed` — [PRO] Get smart money / whale activity feed: large wallet movements and recent swaps on PulseX. Requires OPENPULSECHAIN…
- `get-recent-swaps` — [PRO] Get recent large swaps on PulseX DEX. Requires OPENPULSECHAIN_API_KEY.
- `get-wallet-balances` — [PRO] Get current token balances for a PulseChain wallet. Requires OPENPULSECHAIN_API_KEY.
- `get-wallet-swaps` — [PRO] Get swap history for a PulseChain wallet. Requires OPENPULSECHAIN_API_KEY.
- `get-funding-tree` — [PRO] Trace funding sources for a wallet: where did the money come from? (2-level depth, bridge/DEX interactions). Requ…
- `get-holder-rank` — [PRO] Get holder rank and tier for a wallet address across all tracked tokens. Requires OPENPULSECHAIN_API_KEY.
- `get-bridge-stats` — Get PulseChain bridge statistics: inflows, outflows, net flow over the last 7 days.
- `get-holder-leagues` — Get aggregated holder distribution tiers (poseidon/whale/shark/dolphin/squid/turtle) for a core PulseChain token.
- `get-honeypots` — List recently detected honeypot tokens on PulseChain.
- `get-opportunity-signal` — [PRO] Composite opportunity score (0-100) for a PulseChain token. Combines momentum, volume spike, buy pressure, safety…
- `get-pair-analytics` — [PRO] Detailed analytics for a PulseX trading pair: price, volume, liquidity, buy/sell ratio, price impact estimates, v…
- `get-whale-alerts` — [PRO] Recent whale movements: large swaps (>$10K), LP removals, whale dumps. Combines scam radar + PulseX subgraph data…
- `get-gas` — [PRO] Current PulseChain gas price in Gwei, block number, and base fee. Requires OPENPULSECHAIN_API_KEY.
- `get-token-holders` — [PRO] Top holders of a PulseChain token with balances and ownership percentages. Requires OPENPULSECHAIN_API_KEY.
- `get-token-sentiment` — [PRO] Aggregated social sentiment score (-100 to +100) for a PulseChain token. Based on categorized events (partnership…
- `get-wallet-transactions` — [PRO] Recent transactions for a wallet address (PLS transfers + token transfers). Requires OPENPULSECHAIN_API_KEY.
- `get-tx-trace` — [PRO] Internal call trace for a transaction hash. Shows all internal transfers, contract calls, and token movements. Re…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get openpulsechain/mcp-server <tool-name>
```

## Resources

- `pulsechain://tokens/core`