# OpenPulsechain Analytics (npm · @openpulsechain/mcp-server)

PulseChain analytics: 28 tools — safety scores, signals, whale alerts, pair analytics, AML.

- Trust score: 63/100 (medium)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@openpulsechain/mcp-server`: 63/100 (this document), [markdown](https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server.md), [page](https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@openpulsechain/mcp-server`
- Version: `2.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 93 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 49/100
  - 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1619 tokens (~55/item across 29 items; 28 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add openpulsechain-analytics -- npx -y @openpulsechain/mcp-server
```

### Codex

```bash
codex mcp add openpulsechain-analytics -- npx -y @openpulsechain/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "openpulsechain-analytics": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@openpulsechain/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add openpulsechain-analytics --command npx --arg -y --arg @openpulsechain/mcp-server
```

### Hermes

```yaml
mcp_servers:
  openpulsechain-analytics:
    command: "npx"
    args: ["-y", "@openpulsechain/mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "openpulsechain-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@openpulsechain/mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 63, +58)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Schema quality: unverified → 0
- [functional improvement] License: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-08-01 (score 5, −14)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 0 → unverified

### 2026-07-31 (score 19, +11)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 8, −36)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 0 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Dependency health: unverified → partial

### 2026-07-27 (score 44)

First indexed and scored.

## MCP tools (28)

### `get-token-price` (~76 tokens)

Get Token Price

Get current price, 24h change, volume, and market cap for a PulseChain token.

Input parameters:

- `address` (string, required): Token contract address (0x...) — e.g. 0x2b591e99afe9f32eaa6214f7b7629768c40eeb39 for HEX

Output parameters:

- `address` (string): Token contract address
- `market_cap` (number): Market capitalization in USD
- `price_change_24h` (number): 24-hour price change percentage
- `price_usd` (number): Current price in USD
- `volume_24h` (number): 24-hour trading volume in USD

### `get-token-info` (~44 tokens)

Get Token Info

Get full details for a PulseChain token: name, symbol, decimals, liquidity, volume, holder count.

Input parameters:

- `address` (string, required): Token contract address (0x...)

Output parameters:

- `address` (string): Token contract address
- `decimals` (number): Token decimal places
- `holder_count` (number): Number of token holders
- `name` (string): Token name
- `symbol` (string): Token ticker symbol
- `total_liquidity_usd` (number): Total liquidity in USD
- `volume_24h` (number): 24-hour trading volume in USD

### `get-token-history` (~73 tokens)

Get Token Price History

Get historical price data (OHLCV) for a PulseChain token. Limited to 30 days without API key; Pro unlocks full history.

Input parameters:

- `address` (string, required): Token contract address (0x...)
- `days` (number): Number of days of history (default 30, max 1000)

Output parameters:

- `address` (string): Token contract address
- `days` (number): Number of days returned
- `history` (array): Array of OHLCV candles

### `get-top-tokens` (~58 tokens)

Get Top Tokens

List top PulseChain tokens sorted by volume, liquidity, or symbol.

Input parameters:

- `limit` (number): Number of tokens to return (default 20, max 500)
- `sort_by` (string): Sort field (default: volume)

Output parameters:

- `tokens` (array): Array of top tokens

### `get-top-pairs` (~39 tokens)

Get Top DEX Pairs

List top PulseX DEX trading pairs by volume.

Input parameters:

- `limit` (number): Number of pairs (default 20, max 500)

Output parameters:

- `pairs` (array): Array of top trading pairs

### `get-market-overview` (~34 tokens)

Get Market Overview

Get PulseChain network overview: TVL, 24h volume, active tokens, top gainers/losers.

Output parameters:

- `active_tokens` (number): Number of actively traded tokens
- `top_gainers` (array): Tokens with largest 24h gains
- `top_losers` (array): Tokens with largest 24h losses
- `tvl_usd` (number): Total value locked in USD
- `volume_24h` (number): Total 24-hour volume in USD

### `get-token-safety` (~53 tokens)

Get Token Safety Score

Analyze a token for scam indicators: honeypot detection, buy/sell tax, ownership, liquidity score (0-100, A-F grade).

Input parameters:

- `address` (string, required): Token contract address (0x...)

Output parameters:

- `address` (string): Token contract address
- `buy_tax` (number): Buy tax percentage
- `grade` (string): Letter grade: A (safest) through F (dangerous)
- `is_honeypot` (boolean): Whether the token is detected as a honeypot
- `ownership_renounced` (boolean): Whether contract ownership has been renounced
- `score` (number): Safety score from 0 (dangerous) to 100 (safe)
- `sell_tax` (number): Sell tax percentage

### `get-token-liquidity` (~42 tokens)

Get Token Liquidity

Get detailed liquidity breakdown for a token: all DEX pairs, volumes, and reserves.

Input parameters:

- `address` (string, required): Token contract address (0x...)

Output parameters:

- `address` (string): Token contract address
- `pairs` (array): Array of liquidity pairs
- `total_liquidity_usd` (number): Total liquidity across all pairs in USD

### `check-address-risk` (~58 tokens)

Check Address AML Risk

[PRO] Check if a wallet/contract address is flagged for AML risk, known exploits, phishing, or sanctions (OFAC). Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet or contract address (0x...)

Output parameters:

- `address` (string): Checked address
- `details` (string): Additional risk context
- `flags` (array): List of risk flags (e.g. sanctions, exploit, phishing)
- `risk_level` (string): Risk level: low, medium, high, critical
- `risk_score` (number): Numeric risk score (0-100)

### `get-deployer-reputation` (~58 tokens)

Get Deployer Reputation

[PRO] Get reputation score for a token deployer: how many tokens deployed, how many died (rug pattern detection). Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Deployer wallet address (0x...)

Output parameters:

- `address` (string): Deployer address
- `reputation_score` (number): Reputation score (0-100)
- `rug_pattern` (boolean): Whether a rug pull pattern is detected
- `tokens_dead` (number): Number of tokens that died or were rugged
- `tokens_deployed` (number): Total number of tokens deployed

### `get-scam-alerts` (~77 tokens)

Get Scam Alerts

[PRO] Get real-time scam radar alerts: honeypots, LP removals (rug pulls), whale dumps. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `alert_type` (string): Filter by alert type (omit for all)
- `limit` (number): Number of alerts (default 20, max 200)

Output parameters:

- `alerts` (array): Array of scam alerts

### `get-smart-money-feed` (~78 tokens)

Get Smart Money Feed

[PRO] Get smart money / whale activity feed: large wallet movements and recent swaps on PulseX. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `hours` (number): Lookback period in hours (default 24, max 168)
- `min_usd` (number): Minimum swap value in USD (default 1000)

Output parameters:

- `movements` (array): Array of smart money movements

### `get-recent-swaps` (~70 tokens)

Get Recent DEX Swaps

[PRO] Get recent large swaps on PulseX DEX. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `min_usd` (number): Minimum swap USD value (default 1000)
- `minutes` (number): Lookback in minutes (default 60, max 1440)

Output parameters:

- `swaps` (array): Array of recent swaps

### `get-wallet-balances` (~43 tokens)

Get Wallet Balances

[PRO] Get current token balances for a PulseChain wallet. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet address (0x...)

Output parameters:

- `address` (string): Wallet address
- `balances` (array): Array of token balances
- `total_value_usd` (number): Total portfolio value in USD

### `get-wallet-swaps` (~42 tokens)

Get Wallet Swap History

[PRO] Get swap history for a PulseChain wallet. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet address (0x...)

Output parameters:

- `address` (string): Wallet address
- `swaps` (array): Array of wallet swaps

### `get-funding-tree` (~59 tokens)

Get Funding Tree

[PRO] Trace funding sources for a wallet: where did the money come from? (2-level depth, bridge/DEX interactions). Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet address to trace (0x...)

Output parameters:

- `address` (string): Root wallet address
- `depth` (number): Trace depth level
- `funding_sources` (array): Array of funding sources

### `get-holder-rank` (~47 tokens)

Get Holder Rank

[PRO] Get holder rank and tier for a wallet address across all tracked tokens. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet address (0x...)

Output parameters:

- `address` (string): Wallet address
- `ranks` (array): Array of holder rankings per token

### `get-bridge-stats` (~32 tokens)

Get Bridge Stats

Get PulseChain bridge statistics: inflows, outflows, net flow over the last 7 days.

Output parameters:

- `daily` (array): Daily bridge flow breakdown
- `inflow_usd` (number): Total bridge inflows in USD over the last 7 days
- `net_flow_usd` (number): Net flow (inflow - outflow) in USD
- `outflow_usd` (number): Total bridge outflows in USD over the last 7 days

### `get-holder-leagues` (~47 tokens)

Get Holder Leagues

Get aggregated holder distribution tiers (poseidon/whale/shark/dolphin/squid/turtle) for a core PulseChain token.

Input parameters:

- `symbol` (string, required): Token symbol

Output parameters:

- `symbol` (string): Token symbol
- `tiers` (array): Array of holder tiers

### `get-honeypots` (~40 tokens)

Get Honeypot Tokens

List recently detected honeypot tokens on PulseChain.

Input parameters:

- `limit` (number): Number of results (default 20, max 200)

Output parameters:

- `honeypots` (array): Array of detected honeypot tokens

### `get-opportunity-signal` (~82 tokens)

Get Opportunity Signal

[PRO] Composite opportunity score (0-100) for a PulseChain token. Combines momentum, volume spike, buy pressure, safety, whale activity, and MC/liquidity fragility. Returns confidence level and graceful degradation for partial data. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Token contract address (0x...)

Output parameters:

- `confidence` (string): high, medium, low, insufficient_data
- `data_completeness` (string): full, partial_no_history, safety_only, minimal
- `direction_hint` (string): strong_opportunity, bullish_momentum, neutral_positive, neutral, bearish_pressure, avoid
- `factors` (object): Individual factor scores
- `grade` (string): Grade: A, B+, B, C, D, F
- `kill_signals` (array): Override signals that force score to 0
- `opportunity_score` (number): Composite score 0-100

### `get-pair-analytics` (~65 tokens)

Get DEX Pair Analytics

[PRO] Detailed analytics for a PulseX trading pair: price, volume, liquidity, buy/sell ratio, price impact estimates, volatility, wash trading detection. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Pair contract address (0x...)

Output parameters:

- `computed` (object)
- `metrics` (object)
- `pair_address` (string)
- `price_usd`

### `get-whale-alerts` (~93 tokens)

Get Whale Alerts

[PRO] Recent whale movements: large swaps (>$10K), LP removals, whale dumps. Combines scam radar + PulseX subgraph data. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `hours` (number): Lookback period in hours (default: 24, max: 168)
- `min_usd` (number): Minimum USD value for swaps (default: 10000)

Output parameters:

- `count` (number)
- `data` (array)

### `get-gas` (~36 tokens)

Get Gas Price

[PRO] Current PulseChain gas price in Gwei, block number, and base fee. Requires OPENPULSECHAIN_API_KEY.

Output parameters:

- `base_fee_gwei`: Base fee in Gwei
- `block_number`: Latest block number
- `gas_price_gwei` (number): Current gas price in Gwei

### `get-token-holders` (~69 tokens)

Get Token Holders

[PRO] Top holders of a PulseChain token with balances and ownership percentages. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Token contract address (0x...)
- `limit` (number): Number of holders to return (default: 50, max: 100)

Output parameters:

- `count` (number)
- `data` (array)
- `token_address` (string)

### `get-token-sentiment` (~75 tokens)

Get Token Sentiment

[PRO] Aggregated social sentiment score (-100 to +100) for a PulseChain token. Based on categorized events (partnerships, exploits, dumps, etc.). Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `symbol` (string, required): Token symbol (e.g. PLS, HEX, PLSX)

Output parameters:

- `classification` (string): bullish, bearish, neutral
- `negative_events` (number)
- `positive_events` (number)
- `sentiment_score` (number): -100 (extreme bearish) to +100 (extreme bullish)
- `symbol` (string)
- `total_events` (number)

### `get-wallet-transactions` (~67 tokens)

Get Wallet Transactions

[PRO] Recent transactions for a wallet address (PLS transfers + token transfers). Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `address` (string, required): Wallet address (0x...)
- `limit` (number): Number of transactions (default: 20, max: 50)

Output parameters:

- `data` (array)

### `get-tx-trace` (~55 tokens)

Get Transaction Trace

[PRO] Internal call trace for a transaction hash. Shows all internal transfers, contract calls, and token movements. Requires OPENPULSECHAIN_API_KEY.

Input parameters:

- `tx_hash` (string, required): Transaction hash (0x...)

Output parameters:

- `internal_transactions` (array)
- `transaction` (object)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 63
- 2026-08-01: 5
- 2026-07-31: 19
- 2026-07-30: 8
- 2026-07-28: 44
- 2026-07-27: 44

## Links

- npm package: https://www.npmjs.com/package/@openpulsechain/mcp-server
- Socket report: https://socket.dev/npm/package/@openpulsechain/mcp-server
- Repository: https://github.com/openpulsechain/public
- Changelog RSS feed: https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/openpulsechain-analytics/openpulsechain-mcp-server