Back to Browse

copy.top MCP Server

FinanceModerate7.8RemoteNew
Free

Live signals and alerts from top crypto traders, for AI agents.

About

copy.top is a read-only remote MCP server (Streamable HTTP) with live trades, signals and alerts from top crypto traders on fomo, pumpfun and hyperliquid: trader profiles and leaderboards, live trades, hot coins, trader theses, money flow and ready-made alerts. 11 tools work without a key; an optional API key unlocks hyperliquid tools and alert webhooks. It never places trades and never touches a wallet. Install: claude mcp add --transport http copytop https://copy.top/mcp

Security Report

7.8
Moderate7.8Low Risk

The submitted material contains only the README and two example scripts, not the hosted server's source, so the server's own code could not be audited. The examples are read-only in intent, use an optional Bearer key from an environment variable, and verify webhook HMAC signatures with timingSafeEqual; the main concerns are a missing try/catch around JSON.parse in the webhook receiver and the example listening on all interfaces by default.

3 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "copy-top": {
      "url": "https://copy.top/mcp"
    }
  }
}

Getting Started

Once installed, try these example prompts and explore these capabilities:

  • 1"What are top crypto traders buying right now?"

Documentation

View on GitHub

From the project's GitHub README.

copy.top mcp server

Live crypto trader signals, intel and alerts for AI agents.

The copy.top MCP server gives any AI agent read-only access to what copy.top tracks: which traders are winning on fomo, pumpfun and hyperliquid, what they are buying right now, and alerts when several top traders buy the same coin.

  • Address: https://copy.top/mcp (streamable http, without www)
  • No key needed: 11 tools, 20 calls a minute
  • With a free api key: 19 tools, 60 calls a minute, alert webhooks
  • Read-only: it cannot see an account, place an order or touch a wallet
  • Official MCP registry: top.copy/mcp
  • Docs: https://copy.top/agents

This repository holds the docs and examples. The server itself is hosted by copy.top: there is nothing to install or run.

Connect

Claude Code:

claude mcp add --transport http copytop https://copy.top/mcp

Cursor, Claude Desktop and any other MCP client:

{
  "mcpServers": {
    "copytop": { "type": "http", "url": "https://copy.top/mcp" }
  }
}

With an api key, add the header Authorization: Bearer YOUR_KEY.

As an agent skill:

npx skills add copydottop/skills

What an agent can do with it

GoalAsk your agent
Find traders worth following"who are the 5 best pumpfun traders this week, and what are they holding?"
Spot coins early"which coins did at least 3 top traders buy in the last 2 hours, under $5m market cap?"
Run an alert loop"every minute, check for new confluence alerts and message me the ones above $10k"
Check a coin before buying"which top traders hold this token, and are they selling?"
Follow the money"where did top trader money move in the last hour?"
Read hyperliquid perps (key)"what are the top hyperliquid traders long and short right now?"

Tools

Without a key:

ToolWhat it returns
searchtraders and coins by name, handle, @x, $ticker or address
get_tradera trader's profile: pnl 30d, roi, win rate, fair play verdict, open positions, latest trades and theses
get_leaderboardtraders ranked over 1d, 7d or 30d by pnl, realized, roi, win rate or copiers
get_tokena coin: price, market cap, liquidity, which tracked traders hold or sold it, their theses
get_thesesthe latest or most popular theses posted by tracked traders
get_hot_coinscoins tracked traders are buying now, over 1h or 24h
get_live_tradesthe live tape of buys and sells, newest first, with a cursor
get_alertsconfluence, big trade and thesis events since a cursor, with your thresholds
get_hot_indexcoins ranked 0-100 by attention right now
get_money_flowcoins ranked by dollars bought or sold by tracked traders
get_dex_paidcoins whose team paid for a dexscreener profile in the last 24 h

With a free api key:

ToolWhat it returns
hl_get_tradershyperliquid perp traders ranked by pnl or roi
hl_get_traderone hyperliquid trader: metrics, open positions, latest fills
hl_get_marketslive hyperliquid markets: price, volume, open interest, funding
hl_get_market_reada read of one major market: technicals, funding, positioning of top traders
hl_get_callsx analysts ranked by the track record of their calls on one market
create_alert_webhookpush alerts to your https url, signed
list_alert_webhooksyour webhooks and their delivery state
delete_alert_webhookstop and delete one webhook

The server describes every tool and its parameters itself: call tools/list.

Alerts

By polling, no key. Call get_alerts, keep the cursor it returns, and pass it back as since a minute later. See examples/alerts-poll.mjs.

By webhook, with a key. create_alert_webhook registers your https url and returns a signing secret, shown once. New alerts are posted about once a minute. Each delivery carries the header x-copytop-signature: sha256=<hmac-sha256(secret, raw body)>. Answer 2xx within 5 seconds. See examples/webhook-receiver.mjs.

An alert looks like this:

{
  "kind": "confluence",
  "at": "2026-11-14T21:22:17.065Z",
  "chain": "solana",
  "token": "<mint address>",
  "symbol": "CATE",
  "topTraders": 3,
  "traders": 9,
  "mcap": 15747975,
  "boughtUsd": 7618,
  "soldUsd": 0,
  "url": "https://copy.top/token/solana/<mint address>"
}

Examples

Api keys

Sign in on copy.top, open your account page and create a key under "api keys". It is free. The key is shown once, you can hold three, and you can revoke any of them at any time.

Limits

Calls a minuteTools
Without a key20 per ip11
With a key6019

Search and single trader or coin lookups have a lower limit without a key. A call over the limit gets HTTP 429: wait and retry.

Good to know

  • Figures are data, not advice. Most traders lose money, and a trader's past results do not predict future results.
  • copy.top is independent. It is not affiliated with, endorsed by or operated by fomo, pump.fun or hyperliquid.
  • Questions: @copytop_ on x.

Reviews

No reviews yet

Be the first to review this server!