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
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.
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 GitHubFrom 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, withoutwww) - 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
| Goal | Ask 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:
| Tool | What it returns |
|---|---|
search | traders and coins by name, handle, @x, $ticker or address |
get_trader | a trader's profile: pnl 30d, roi, win rate, fair play verdict, open positions, latest trades and theses |
get_leaderboard | traders ranked over 1d, 7d or 30d by pnl, realized, roi, win rate or copiers |
get_token | a coin: price, market cap, liquidity, which tracked traders hold or sold it, their theses |
get_theses | the latest or most popular theses posted by tracked traders |
get_hot_coins | coins tracked traders are buying now, over 1h or 24h |
get_live_trades | the live tape of buys and sells, newest first, with a cursor |
get_alerts | confluence, big trade and thesis events since a cursor, with your thresholds |
get_hot_index | coins ranked 0-100 by attention right now |
get_money_flow | coins ranked by dollars bought or sold by tracked traders |
get_dex_paid | coins whose team paid for a dexscreener profile in the last 24 h |
With a free api key:
| Tool | What it returns |
|---|---|
hl_get_traders | hyperliquid perp traders ranked by pnl or roi |
hl_get_trader | one hyperliquid trader: metrics, open positions, latest fills |
hl_get_markets | live hyperliquid markets: price, volume, open interest, funding |
hl_get_market_read | a read of one major market: technicals, funding, positioning of top traders |
hl_get_calls | x analysts ranked by the track record of their calls on one market |
create_alert_webhook | push alerts to your https url, signed |
list_alert_webhooks | your webhooks and their delivery state |
delete_alert_webhook | stop 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
examples/curl.sh: raw JSON-RPC callsexamples/alerts-poll.mjs: an alert loop in 30 lines, no dependencyexamples/webhook-receiver.mjs: receive webhooks and check the signature
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 minute | Tools | |
|---|---|---|
| Without a key | 20 per ip | 11 |
| With a key | 60 | 19 |
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!
More Finance MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Lharries · Communication
Read, search, and send WhatsApp messages through your AI assistant
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
Memory
Freeby Modelcontextprotocol · Productivity
Knowledge graph-based persistent memory across sessions