Skip to content
Back to search

stalkchain

MarketplaceWorks with Claude CodeGitHub

StalkChain's plugins for Claude Code and Cowork: crypto research on live trader, token and wallet data.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stalkc--stalkchain-plugin/badge.svg)](/listings/stalkc--stalkchain-plugin)

HTML

<a href="/listings/stalkc--stalkchain-plugin"><img src="/api/listings/stalkc--stalkchain-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Add the StalkChain marketplace from this repository and install the plugin:

codex plugin marketplace add StalkC/stalkchain-plugin
codex plugin add stalkchain@stalkchain

Open the plugin in Codex and connect StalkChain Data. Sign in with your StalkChain account before making a lookup. Lookups use account credits.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "stalkchain",
  3. "description": "StalkChain's plugins for Claude Code and Cowork: crypto research on live trader, token and wallet data.",
  4. "owner": { "name": "StalkChain", "url": "https://stalkchain.com" },
  5. "plugins": [
  6. {
  7. "name": "stalkchain",
  8. "source": "./",
  9. "description": "See what FOMO's top traders are buying, check a coin before you buy, vet a trader before you copy them, review a wallet and set price alerts. Never trades or moves funds.",
  10. "category": "finance"
  11. }
  12. ]
  13. }
README.md · README · 218 lines
  1. # StalkChain for Claude
  2. Crypto research in plain English. Ask Claude to check a coin before you buy it, vet a trader before you copy them, see what the top traders are buying right now, review a wallet, or alert you when a price is crossed. It works across Solana, Ethereum, Base, BNB Chain, Monad, Hyperliquid and Robinhood Chain, plus the StonkFun launchpad.
  3. The plugin never trades, moves funds or signs anything. The only thing it can change is your own StalkChain alerts, and only after you confirm.
  4. ## What's inside
  5. **The StalkChain connector** (`.mcp.json`) connects Claude to StalkChain's live data: tracked traders and their real wallets, profit, positions and trades, smart-money holders, dev and insider positions, buy and sell flow, on-chain safety checks, wallet histories, DeFi yields and hacks, and StonkFun launches.
  6. **Skills** teach Claude how to research, not just which tool to call. Each one checks the cheapest data first and answers in a consistent format. In Claude Code and Cowork you can also run them as commands, for example `/stalkchain:token-check <address>`.
  7. | Skill | Ask something like |
  8. | --- | --- |
  9. | `token-check` | "Is this coin safe? Is it a honeypot? Is the dev selling?" |
  10. | `trader-check` | "Should I copy this trader? Compare these three." |
  11. | `trader-playbook` | "How does this trader actually trade? How long do they hold?" |
  12. | `universal-trade-review` | "Review @trader's last week trade by trade" or "review my own trades and draft rules for next week." |
  13. | `smart-money-radar` | "What did the top traders buy in the last hour?" |
  14. | `whale-watch` | "Any big buys or sells over $50K today? Who are the biggest Hyperliquid whales?" |
  15. | `perps-check` | "Is SOL funding positive on Hyperliquid, and higher than Binance? Are TSLA longs crowded?" |
  16. | `launch-screener` | "Any new launches worth a look today?" |
  17. | `narrative-tracker` | "What are the narratives right now?" |
  18. | `token-compare` | "Compare these three coins side by side." |
  19. | `rug-post-mortem` | "What happened to this coin? Was it a rug?" |
  20. | `holder-tracker` | "Who joined or left this token's holders since yesterday?" |
  21. | `wallet-lookup` | "What does this wallet hold, and how old is it?" |
  22. | `portfolio-review` | "What's risky in my bags?" |
  23. | `price-alerts` | "Email me when BONK goes above $0.00005." |
  24. | `defi-safety` | "Where can I earn on USDC? Has this protocol been hacked?" |
  25. | `liquidity-pools` | "Does burning a v3/v4 LP NFT lock the principal? Who controls launch liquidity and fees?" |
  26. | `stonkfun-research` | "What's trending on StonkFun? Show this token's burns." |
  27. | `stonkfun-launch-guide` | "Help me plan a StonkFun launch paired with an xStock." |
  28. **Agents** handle longer jobs in Cowork and Claude Code:
  29. | Agent | What it does |
  30. | --- | --- |
  31. | `crypto-researcher` | Multi-coin or multi-trader research that ends in a written report. |
  32. | `watchlist-analyst` | Works through `watchlist.md` or `watchlist.json` in your project and writes a dated daily brief to `briefs/`. Pairs well with a scheduled task. |
  33. | `due-diligence-reviewer` | A second opinion: re-checks a research report against fresh data and flags claims the data doesn't support. |
  34. **Interactive cards.** In Claude and ChatGPT, token analysis and safety checks, trader reports and comparisons, multi-trader entries, the leaderboard, wallet portfolios, the live trade feed, DeFi yields and StonkFun token reports appear as interactive cards: switch a chart's timeframe or the leaderboard's window in place, or tap through to the next question. Claude adds the interpretation on top.
  35. ## Get started
  36. 1. In Claude Code, add this repository as a plugin marketplace and install StalkChain. A public listing in each app is a separate review; repository installation does not mean the plugin is approved in that app's directory:
  37. ```
  38. /plugin marketplace add StalkC/stalkchain-plugin
  39. /plugin install stalkchain@stalkchain
  40. ```
  41. 2. Connect **StalkChain** (the plugin's **Connectors** tab, or `/mcp` in Claude Code) and sign in with your StalkChain account. You'll need credits, which you can buy at [data.stalkchain.com](https://data.stalkchain.com).
  42. 3. Ask a question, for example "What are the top traders buying on Solana right now?"
  43. ### Install StalkChain in Codex
  44. Add the StalkChain marketplace from this repository and install the plugin:
  45. ```sh
  46. codex plugin marketplace add StalkC/stalkchain-plugin
  47. codex plugin add stalkchain@stalkchain
  48. ```
  49. Open the plugin in Codex and connect StalkChain Data. Sign in with your
  50. StalkChain account before making a lookup. Lookups use account credits.
  51. ### Install an individual skill in Codex
  52. From the project where you want to use the skill, install it with the
  53. [Skills CLI](https://www.skills.sh/docs/cli):
  54. ```bash
  55. npx skills add https://github.com/StalkC/stalkchain-plugin --skill trader-check --agent codex
  56. ```
  57. Choose another name from the skills table to install a different skill. In Codex,
  58. connect [StalkChain Data](https://data.stalkchain.com/docs/guides/getting-started)
  59. and sign in separately. StalkChain lookups use account credits.
  60. ### Build a ChatGPT upload archive
  61. For a manual upload in a compatible ChatGPT workspace, build an Agent Plugins
  62. archive from a committed checkout. This includes the existing provider-neutral
  63. manifest and MCP definition; upload/review availability depends on the workspace.
  64. ```bash
  65. mkdir -p dist
  66. git archive --format=zip --output=dist/stalkchain-chatgpt.zip HEAD \
  67. plugin.json mcp.json skills agents assets/icon.png assets/logo.png README.md LICENSE
  68. ```
  69. Upload `dist/stalkchain-chatgpt.zip` where your workspace offers **Upload plugin
  70. archive**. `mcp.json` keeps the remote server URL unchanged; the client discovers
  71. OAuth sign-in from the server's protected-resource and authorization metadata.
  72. An upload is not public directory approval. The archive-building command is a
  73. manual maintainer step; the plugin does not run it on installation.
  74. ### Package maintenance
  75. The distributed plugin contains Markdown, JSON, license text and PNG images.
  76. Keep build helpers outside the package and use the PNG logo when adding a new
  77. client manifest. This lets the remote MCP and skills be reviewed without shipping
  78. an executable helper or an SVG asset. The catalog still performs its own safety
  79. and policy review; a local validation pass does not guarantee directory approval.
  80. ### Hermes Agent
  81. Plugin page: https://hermes-agent.nousresearch.com/docs/plugins/stalkchain
  82. From the Hermes plugin catalog:
  83. ```bash
  84. hermes plugins install stalkchain
  85. hermes plugins enable stalkchain
  86. ```
  87. Or directly from this repository:
  88. ```bash
  89. hermes plugins install StalkC/stalkchain-plugin --no-enable
  90. hermes plugins enable stalkchain
  91. ```
  92. Then connect your StalkChain account. Hermes signs in only to MCP servers you
  93. add yourself, so add the StalkChain server once:
  94. ```bash
  95. hermes mcp add stalkchain --url https://data.stalkchain.com/mcp/directory --auth oauth --connect-timeout 300
  96. ```
  97. Your browser opens the StalkChain sign-in page. Sign in with email or X and
  98. approve access; the command waits up to five minutes. Hermes then lists the
  99. StalkChain tools; press Enter to keep them all. The tools are available from
  100. your next session (or after `/reload-mcp`). To sign in again later, run
  101. `hermes mcp login stalkchain`. On a remote or headless host, use the paste-back
  102. prompt or an SSH port forward described in the Hermes MCP docs.
  103. In **Hermes Desktop**, open **Capabilities → Connectors**, choose **Add your
  104. own** and enter:
  105. | Field | Value |
  106. | --- | --- |
  107. | Name | `stalkchain` |
  108. | Type | Streamable HTTP |
  109. | URL | `https://data.stalkchain.com/mcp/directory` |
  110. | Auth | OAuth |
  111. Save, then choose **Authenticate** on the StalkChain card.
  112. Keep the name `stalkchain`. Your own entry then takes the place of the server
  113. entry in the plugin, and the plugin keeps providing the skills (find them with
  114. `skills_list`).
  115. **Unattended runs (cron, messaging gateway).** OAuth tokens refresh on their
  116. own. If a refresh ever fails, Hermes parks the server instead of waiting for a
  117. browser; run `hermes mcp login stalkchain` once to reconnect.
  118. **What Hermes loads from this package.** `mcp.json` (the StalkChain server) and
  119. the 19 skills under `skills/`. The `agents/` folder and the `.claude-plugin/`
  120. files are for Claude, `.cursor-plugin/` is for Cursor, and Hermes ignores them.
  121. There is no Python, no
  122. executable and no self-updating code. OAuth tokens are stored by Hermes itself
  123. (`~/.hermes/mcp-tokens/stalkchain.json`), not by this plugin.
  124. ### Cursor
  125. **Install.** Open **Customize** in Cursor, search for **StalkChain** and choose
  126. **Install** (project or user scope). Until it's listed in the Cursor
  127. Marketplace, you can install it either of these ways:
  128. - **Team marketplace** (Teams and Enterprise): **Dashboard → Plugins & MCPs →
  129. Team Marketplaces → Add Marketplace → Import from Repo**, and paste
  130. `https://github.com/StalkC/stalkchain-plugin`.
  131. - **Locally:** clone it into Cursor's local plugin folder, then run
  132. **Developer: Reload Window**.
  133. ```bash
  134. git clone https://github.com/StalkC/stalkchain-plugin ~/.cursor/plugins/local/stalkchain
  135. ```
  136. **Connect.** In **Customize**, find the **stalkchain** MCP server, switch it on
  137. and choose **Connect**. Your browser opens the StalkChain sign-in page; sign in
  138. with email or X and approve access. Then ask in Agent chat, for example "What
  139. are the top traders buying on Solana right now?" The skills load when your
  140. question matches; run one directly with `/token-check <address>` and the like.
  141. The three agents are available as subagents.
  142. **Just the connector, without the skills:** use this install link, or add the
  143. server to `~/.cursor/mcp.json` yourself.
  144. ```text
  145. cursor://anysphere.cursor-deeplink/mcp/install?name=stalkchain&config=eyJ1cmwiOiJodHRwczovL2RhdGEuc3RhbGtjaGFpbi5jb20vbWNwL2RpcmVjdG9yeSJ9
  146. ```
  147. ```json
  148. { "mcpServers": { "stalkchain": { "url": "https://data.stalkchain.com/mcp/directory" } } }
  149. ```
  150. **What Cursor loads from this package.** `.cursor-plugin/plugin.json`, the 19
  151. skills under `skills/`, the three agents under `agents/` and the server in
  152. `.mcp.json`. No rules, hooks, commands or scripts.
  153. ## Data and privacy
  154. Educational liquidity-pool questions can use the bundled read-only references without a connector call. Historical examples are not live verification; specific pool assessments require fresh evidence and may remain unknown.
  155. When Claude uses the StalkChain connector, it sends requests to `https://data.stalkchain.com/mcp/directory`. Each call sends only the name of the tool and its inputs, such as a token address, a trader handle or a wallet address. Your conversation is never sent. Each call spends credits from your StalkChain account.
  156. Alerts created through this plugin go to the email address on your StalkChain account. You can also list and delete existing alerts.
  157. The plugin itself has no scripts and no hooks. The holder-tracker skill and the watchlist-analyst agent save snapshots and briefs as files in your own project, and nowhere else. Universal trade review can save append-only, trader/account-isolated review records locally at the caller-approved path; drafts never change live trading rules. Data returned describes public blockchain activity and public posts by traders. See the [privacy policy](https://data.stalkchain.com/privacy) and [terms](https://data.stalkchain.com/terms).
  158. Nothing here is financial advice.
  159. ## Support
  160. Questions and issues: [stalkchain.com/mcp](https://stalkchain.com/mcp), or open an issue in this repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.