connect in one line
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. use this exact address, without www.
as an agent skill: npx skills add copydottop/skills
what your agent can do with it
rank traders by realized pnl, win rate or hold time, then read one trader in depth before trusting them.
« who are the 5 best pumpfun traders this week, and what are they holding? »list the coins top traders bought in the last hours, with who bought and how much.
« which coins did at least 3 top traders buy in the last 2 hours, under $5m market cap? »poll alerts with a cursor, or receive them on your own url: confluence between top traders, big trades, new theses.
« every minute, check for new confluence alerts and message me the ones above $10k. »read who holds a coin among top traders, who is selling it, and what they wrote about it.
« before i buy this token, tell me which top traders hold it and whether they are selling. »read where trader money is going right now: by coin, by direction, over a time window.
« where did top trader money move in the last hour? »with an api key: the best perp traders, their open positions and the markets they trade.
« what are the top hyperliquid traders long and short right now? »tools without a key
search | find traders and coins on copy.top by name, handle, @x, $ticker or address. use it to resolve a name before the other tools. |
get_trader | a trader's copy.top profile (fomo or pump.fun): pnl 30d (realized, unrealized, total), roi, win rate, fair play verdict and badges, followers, copiers, platforms, largest open positions, latest trades and theses. |
get_leaderboard | rank traders like copy.top's discover page. window 1d, 7d or 30d; sort total (pnl), realized, roi, winrate or copiers; optional chain or platform (fomo, pumpfun); fair_play clean or clean_or_watch keeps only those. |
get_token | a coin's copy.top page: price, market cap, 1h and 24h moves, liquidity, which tracked traders hold it or sold it and their pnl on it, and their theses. |
get_theses | the latest or most popular theses (a trader's written reason for holding a coin) posted by tracked traders in the last 24 h at most, with the coin and their pnl at post. |
get_hot_coins | the signal feed: coins tracked traders are buying now. window 1h or 24h, optional max market cap in dollars. each coin: how many traders and top traders bought, dollars bought and sold, minutes since the first buy, and the first buyers. |
get_live_trades | the live tape: the latest buys and sells by tracked traders (fomo and pump.fun), newest first. optional since (iso time or the cursor of a previous call) to get only newer trades, side buy or sell, min_usd. |
get_alerts | events since a cursor, for alert bots: confluence (several top traders bought the same coin recently), big_trade (one tracked trader bought or sold a large amount) and thesis (a tracked trader posted a thesis). pass the cursor of the previous call as since; without since, the last 15 minutes. thresholds are yours. |
get_hot_index | copy.top's hot index: coins ranked 0-100 by attention right now, mixing tracked traders buying, callers and x activity (voices, views). window 1h, 6h or 24h; optional chain. |
get_money_flow | where tracked traders' dollars go: coins ranked by dollars bought (side buy) or sold (side sell) over 1h, 6h, 24h or 7d, with the number of traders. |
get_dex_paid | coins whose team paid for a dexscreener profile in the last 24 h (a sign the team is spending), with price, market cap, liquidity, volume and moves. |
tools with a free api key
hl_get_traders | rank hyperliquid perps traders tracked by copy.top. window 24h, 7d, 30d or all; sort pnl or roi. each row: address, name, account value, pnl, roi, volume, win rate, style, trades per day, max drawdown 30d, top coins. |
hl_get_trader | a hyperliquid trader by address: profile and metrics (win rate, profit factor, drawdown, usual leverage, score), pnl per window, open positions with entry, size, leverage and liquidation price, and latest fills. |
hl_get_markets | live hyperliquid markets (crypto perps and hip-3: stocks, indices, commodities, fx): mark price, 24h change, 24h volume, open interest, hourly funding, max leverage. optional category; sorted by 24h volume. |
hl_get_market_read | copy.top's read of one major hyperliquid market: technicals (rsi, emas, trend), funding vs its history and other venues, premium, open interest changes, what the top 300 traders hold and their latest moves, nearby liquidations, fear and greed. |
hl_get_calls | x analysts ranked by the track record of their calls on one hyperliquid market, and their recent calls. |
create_alert_webhook | push alerts to your server: copy.top will POST new events (confluence, big_trade, thesis) to an https url, checked once a minute, with your thresholds. returns a signing secret, shown once. needs an api key. up to 3 webhooks per key. |
list_alert_webhooks | your alert webhooks: url, thresholds, whether each is active, last delivery, events sent, and the last error if it is failing. |
delete_alert_webhook | stop and delete one of your alert webhooks, by the id list_alert_webhooks returned. |
alerts
by polling. call get_alerts, keep the cursor it returns, and pass it back as since a minute later. you get confluence, big trade and thesis events, filtered by your own thresholds. no key needed.
by webhook. with an api key, create_alert_webhook registers your https url. new alerts are posted to it about once a minute, signed with a secret so you can check they come from copy.top.
get an api key
sign in on copy.top, open your account 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.
questions
what is the copy.top mcp server?
the copy.top mcp server gives any ai agent live, read-only crypto data: 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.
is it free?
yes. 11 tools work without a key, at 20 calls a minute. a free api key raises the limit to 60 calls a minute and adds 8 more tools.
do i need an api key?
no. the server answers without one. a key is only needed for the hyperliquid tools, alert webhooks and the higher limit.
how do i get an api key?
sign in on copy.top, open your account page, and create a key under « api keys ». the key is shown once. you can hold three keys and revoke any of them.
can the server trade or move funds?
no. it is read-only. it cannot see an account, place an order or touch a wallet.
which ai clients does it work with?
any client that speaks the model context protocol over streamable http: claude, claude code, cursor, and agent frameworks with an mcp client.
which markets does it cover?
traders from the fomo app and from pumpfun across the chains copy.top supports, and hyperliquid perp traders with an api key.
how fresh is the data?
live trades and alerts follow the market within seconds to about a minute. rankings and trader pages are recomputed through the day.
is this financial advice?
no. figures are data, not advice. most traders lose money, and a trader's past results do not predict future results.
links
- server address: https://copy.top/mcp
- examples and source of the skill: github.com/copydottop
- what copy.top is: about · facts for ai assistants