# @openpulsechain/mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/openpulsechain/public/tree/main/mcp-server  
**GitHub Stars:** 3  
**npm Downloads (last month):** 190  
**Views:** 10  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/-openpulsechain-mcp-server

## Description
PulseChain on-chain analytics: token safety scores (0-100), honeypot detection, whale tracking, smart money feed, scam alerts, DEX volume, bridge stats, holder leagues. 11 free + 9 pro tools. npx @openpulsechain/mcp-server

## Tools
Capabilities this server exposes over MCP:

- **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). Requires OPENPULSECHAIN_API_KEY.
- **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.
- **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_API_KEY.
- **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). Requires OPENPULSECHAIN_API_KEY.
- **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, whale activity, and MC/liquidity fragility. Returns confidence level and graceful degradation for partial data. Requires OPENPULSECHAIN_API_KEY.
- **get-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.
- **get-whale-alerts** — [PRO] Recent whale movements: large swaps (>$10K), LP removals, whale dumps. Combines scam radar + PulseX subgraph data. Requires OPENPULSECHAIN_API_KEY.
- **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 (partnerships, exploits, dumps, etc.). Requires OPENPULSECHAIN_API_KEY.
- **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. Requires OPENPULSECHAIN_API_KEY.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What @openpulsechain/mcp-server does

@openpulsechain/mcp-server exposes PulseChain on-chain analytics to MCP clients. Its free tier covers current token prices, token metadata, historical OHLCV data, ranked tokens and pairs, network-level market statistics, token safety analysis, liquidity, detected honeypots, bridge flows, and holder distribution tiers.

A Pro tier adds address-risk checks, deployer reputation, scam alerts, large-wallet activity, large PulseX swaps, wallet balances, wallet swap history, funding-source tracing, and holder rankings. The server also publishes a `pulsechain://tokens/core` resource containing addresses for WPLS, HEX, PLS, PLSX, INC, eHEX, DAI, USDC, USDT, WETH, and WBTC.

## How it works

The server runs as a local stdio process launched with `npx`. It retrieves analytics from `api.openpulsechain.com` and safety, alert, tracing, and league data from `safety.openpulsechain.com`. Those backends source information from the PulseX Subgraph, Blockscout Explorer, and on-chain RPC calls.

Without an API key, the 11 standard tools are available. Supplying `OPENPULSECHAIN_API_KEY` switches the process to Pro mode and makes all 20 tools callable. Pro requests send the key as a bearer token to the backend; the key is not cached by the server.

## Setup and configuration

Run the server directly with:

```bash
npx @openpulsechain/mcp-server
```

For Claude Desktop, add an MCP entry that runs `npx -y @openpulsechain/mcp-server` as the command and argument. Claude Code uses the same command in `.claude/settings.json`. Cursor is also named as a supported MCP client.

To activate Pro tools, add the API key to the MCP server environment:

```json
{
  "env": {
    "OPENPULSECHAIN_API_KEY": "sk-opk-..."
  }
}
```

Keys are available through the OpenPulseChain pricing page.

## Tools and capabilities

The 11 standard tools provide:

- Current prices, 24-hour changes, volume, and market capitalization
- Token details such as decimals, liquidity, and holders
- Up to 30 days of historical price data without an API key
- Rankings for tokens and PulseX trading pairs
- Network TVL, volume, gainers, and losers
- Honeypot detection, buy and sell taxes, and ownership grades
- Liquidity breakdowns, recent honeypots, bridge flows, and holder leagues

The nine Pro tools support sanctions and exploit checks, deployer history, scam alerts, whale activity, large swaps, wallet balances, wallet swap history, two-level funding traces, and holder ranking.

## Limitations and notes

The server is read-only: it does not sign transactions, access seed phrases, or perform write operations. Requests are rate-limited by the backend, with stricter limits without an API key. Historical token data is limited to 30 days in the standard tier. Calling a Pro tool without a key returns a `pro_tier_required` error.

_Full upstream README: https://allmcps.com/mcp/-openpulsechain-mcp-server/readme_