⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.0.0

chainstream-data

chainstream-io@chainstream-io⭐ 1 stars· last commit 3mo ago· 0 open issues

Query and analyze on-chain data via MCP (17 tools) and CLI across Solana, BSC, Ethereum. Use when user asks to search tokens, check token security or holders, track market trends or hot tokens, analyze wallet PnL or holdings, stream real-time trades, compare multiple tokens, or backtest trading strategies. Covers token analytics, market ranking, wallet profiling, and WebSocket streaming. Keywords: token, wallet, market, trending, PnL, holders, security, candles, WebSocket, on-chain data, MCP.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

ChainStream AI Skills

License: MIT

On-chain data intelligence and DeFi execution for AI agents across Solana, BSC, and Ethereum.

Skills

SkillCoveragePattern
chainstream-dataToken search, market trending, wallet PnL, WebSocketTool
chainstream-graphqlCustom GraphQL queries, cross-cube JOINs, aggregations, 25 on-chain cubes (3 chain groups)Tool
chainstream-defiToken swap, cross-chain bridge, launchpad, transaction broadcastProcess

When to Use Which

User intent involves reading data?
  Standard queries (token info, market trends, wallet analysis)?
    → chainstream-data (REST API / MCP — pre-built endpoints)
  Custom analytics (cross-cube JOIN, aggregation, complex filters)?
    → chainstream-graphql (GraphQL — flexible queries on 25 cubes in 3 chain groups)

User intent involves executing a transaction?
  → chainstream-defi (swap, bridge, create token, send tx)

Installation

Cursor

Skills are automatically discovered via .cursor-plugin/ configuration. Install the CLI:

npx @chainstream-io/cli login

Claude Code

/plugin install chainstream

Codex

See .codex/INSTALL.md.

OpenCode

See .opencode/INSTALL.md.

Gemini CLI

gemini extensions install https://github.com/chainstream-io/skills

Authentication

IMPORTANT: Run chainstream login before any CLI command. This creates a wallet and enables authentication. Without it, all commands will fail with "Not authenticated".

MethodCommandUse Case
Wallet (default)chainstream loginCreates a ChainStream managed wallet, no email needed. Run this first.
Import keychainstream wallet set-raw --chain base (EVM) or --chain sol (Solana)Use your own private key
Email loginchainstream login --email [email protected]Recover wallet on new device
Bind emailchainstream bind-email [email protected]Optional, for account recovery
API Keychainstream config set --key apiKey --value <key>Read-only, dashboard users
x402 (USDC)Interactive on 402CLI prompts for plan selection, pays with USDC (Base/Solana). Quota is in CU (Compute Units), not call count
x402 → API KeyInteractive on 402Same as above — also returns API Key for MCP/SDK use

Free trial: chainstream login auto-grants a nano plan ($1, 50K CU, 30 days). bind-email or login --email auto-upgrades to micro plan ($5, 350K CU, 30 days). Dedup by email — same email only grants once. No manual purchase needed for trial.

Usage Examples

Natural language prompts you can send to any AI assistant with ChainStream skills:

search for meme tokens on Solana
is <token_address> safe to buy?
show top holders of <token_address>
what tokens are trending on SOL right now?
show my wallet PnL on Solana
check my current subscription status
swap 0.1 SOL for <token_address>
check job status <job_id>
show K-line chart for <token_address>
what cubes are available in the GraphQL schema?
query the top 50 tokens by 24h volume using GraphQL

CLI

Install via npx (no global install needed):

npx @chainstream-io/cli token search --keyword PUMP --chain sol
npx @chainstream-io/cli market trending --chain sol --duration 1h
npx @chainstream-io/cli wallet pnl --chain sol --address <addr>
npx @chainstream-io/cli dex route --chain sol --from <wallet> --input-token SOL --output-token <addr> --amount 1000000
npx @chainstream-io/cli graphql schema --summary
npx @chainstream-io/cli graphql query --query 'query { Solana { DEXTradeByTokens(where: {Trade: {Currency: {MintAddress: {is: "TOKEN_ADDRESS"}}}}, limit: {count: 10}, orderBy: {descending: Block_Time}) { Block { Time } Trade { Currency { Symbol } Amount AmountInUSD Side { Type } } } } }'

MCP Server

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": { "X-API-KEY": "<your-api-key>" }
    }
  }
}

Supported Chains

ChainIDDataDeFiWebSocket
SolanasolYesYesYes
BSCbscYesYesYes
EthereumethYesYesYes

Resources

License

MIT

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • chainstream-data/SKILL.md7.9 KBupstream ↗
    ---
    name: chainstream-data
    description: "Query and analyze on-chain data via MCP (17 tools) and CLI across Solana, BSC, Ethereum. Use when user asks to search tokens, check token security or holders, track market trends or hot tokens, analyze wallet PnL or holdings, stream real-time trades, compare multiple tokens, or backtest trading strategies. Covers token analytics, market ranking, wallet profiling, and WebSocket streaming. Keywords: token, wallet, market, trending, PnL, holders, security, candles, WebSocket, on-chain data, MCP."
    ---
    
    # ChainStream Data
    
    On-chain data intelligence for AI agents. Access token analytics, market trends, wallet profiling, and compliance screening across Solana, BSC, and Ethereum.
    
    - **MCP Server**: `https://mcp.chainstream.io/mcp` (streamable-http, 17 tools)
    - **CLI**: `npx @chainstream-io/cli`
    - **SDK**: `@chainstream-io/sdk`
    - **Base URL**: `https://api.chainstream.io`
    
    ## Integration Path (check FIRST)
    
    **Agent runtime decision tree — choose based on environment and operation type:**
    
    1. **MCP tools registered?** (Cursor/Claude Desktop/VS Code already configured ChainStream MCP)
       → YES → Use MCP tools for data queries (`tokens_search`, `wallets_profile`, etc.)
       → NO → Use CLI for all operations (`npx @chainstream-io/cli ...`)
    
    2. **Need DeFi operation?** (swap, create token, sign transaction)
       → YES → Must use CLI (MCP has no wallet signing capability)
       → NO → Continue with MCP (or CLI if MCP unavailable)
    
    3. **MCP call failed?**
       → Fall back to CLI as backup
    
    **Before anything else (CLI path), ensure user is authenticated:**
    1. `npx @chainstream-io/cli config auth` — check login status
    2. If NOT logged in → `npx @chainstream-io/cli login` (creates EVM + Solana wallet, auto-grants **nano trial plan: 50K CU free, 30 days** — no purchase needed)
    3. If logged in → proceed to subscription check below
    
    **New users get a free trial on login (50K CU).** For details on trial plans and upgrade options, see [`shared/authentication.md`](../shared/authentication.md#agent-bootstrap-checklist).
    
    **Then check subscription:** `npx @chainstream-io/cli plan status`
    - If `active: true` → proceed with data queries
    - If no subscription → follow the purchase flow below (NEVER just run a data command hoping it "auto-purchases")
    
    **Getting an API Key (required for all paths):**
    - Dashboard users: [app.chainstream.io](https://app.chainstream.io) → API Keys
    - x402 (USDC on Base/Solana): `npx @chainstream-io/cli plan purchase --plan <PLAN> --json` → x402 purchase (real USDC payment via EIP-3009 signature). Run `wallet pricing --json` first, present ALL plans, let user choose
    - MPP (USDC.e on Tempo): `tempo request "https://api.chainstream.io/mpp/purchase?plan=<PLAN>"` → MPP payment → API Key auto-returned (fetch `/mpp/pricing` first, let user choose plan)
    
    **⚠️ Purchase flow (x402)**:
    0. `config auth` — ensure user is logged in. If not: `login` first (auto-grants nano trial — may be sufficient, check `plan status` before proceeding to purchase)
    1. `plan status --json` — check if subscription already exists (login auto-grants nano trial, so new users likely already have one)
    2. If `active: true` and quota sufficient → no purchase needed, proceed with data queries
    3. If no subscription or quota exhausted: `wallet pricing --json` — present ALL plans, let user choose. **NEVER auto-select a plan.**
    4. `wallet balance --chain base --json` (and/or `--chain sol`) — check where user has USDC
    5. If USDC is on Solana: `config set --key walletChain --value sol` (default is `base`)
    6. `plan purchase --plan <USER_CHOSEN> --json` — x402 purchase (real USDC payment). API Key auto-saved to config
    
    **⚠️ Quota is CU, NOT call count**: Plan quota is measured in **Compute Units (CU)**, not API call count. Each API endpoint costs a different amount of CU per call (varies by endpoint complexity and response size). When presenting plans to the user, always use "CU" as the unit — NEVER say "calls" or "requests".
    
    **Channel matrix:**
    
    | Operation | MCP (when registered) | CLI | SDK |
    |-----------|----------------------|-----|-----|
    | Search tokens | `tokens_search` | `token search` | `client.token.search` |
    | Analyze token | `tokens_analyze` | `token info` | `client.token.getToken` |
    | Price history | `tokens_price_history` | `token candles` | `client.token.getCandles` |
    | Wallet profile | `wallets_profile` | `wallet profile` | `client.wallet.*` |
    | Market trending | `market_trending` | `market trending` | `client.ranking.*` |
    | DEX quote | `dex_quote` | `dex route` | `client.dex.route` |
    | DEX swap | _(no signing)_ | `dex swap` | `client.dex.swap` + sign |
    | Create token | _(no signing)_ | `dex create` | `client.dex.createToken` |
    
    ## Prerequisites
    
    ### MCP path (recommended for data queries)
    
    Add to your MCP client configuration (Cursor, Claude Desktop, VS Code):
    
    ```json
    {
      "mcpServers": {
        "chainstream": {
          "url": "https://mcp.chainstream.io/mcp",
          "headers": { "X-API-KEY": "<your-api-key>" }
        }
      }
    }
    ```
    
    ### CLI path
    
    ```bash
    # Option A: Use API Key (recommended — works with all agent wallets)
    npx @chainstream-io/cli config set --key apiKey --value <your-api-key>
    
    # Option B: Create ChainStream Wallet (for DeFi + auto x402 payment)
    npx @chainstream-io/cli login
    
    # Option C: Import existing key (dev/testing)
    npx @chainstream-io/cli wallet set-raw --chain base   # EVM (Base) key
    npx @chainstream-io/cli wallet set-raw --chain sol     # Solana key
    ```
    
    ### SDK path
    
    `npm install @chainstream-io/sdk` — see [`shared/authentication.md`](../shared/authentication.md) Path 2 for `WalletSigner` integration.
    
    ## Endpoint Selector
    
    ### Token
    
    | Intent | CLI Command | MCP Tool | Reference |
    |--------|-------------|----------|-----------|
    | Search tokens | `npx @chainstream-io/cli token search --keyword X --chain sol` | `tokens_search` | [token-research.md](references/token-research.md) |
    | Token detail | `npx @chainstream-io/cli token info --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references/token-research.md) |
    | Security check | `npx @chainstream-io/cli token security --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references/token-research.md) |
    | Top holders | `npx @chainstream-io/cli token holders --chain sol --address ADDR` | `tokens_analyze` | [token-research.md](references/token-research.md) |
    | K-line / OHLCV | `npx @chainstream-io/cli token candles --chain sol --address ADDR --resolution 1h` | `tokens_price_history` | [token-research.md](references/token-research.md) |
    | Liquidity pools | `npx @chainstream-io/cli token pools --chain sol --address ADDR` | `tokens_discover` | [token-research.md](references/token-research.md) |
    
    ### Market
    
    | Intent | CLI Command | MCP Tool | Reference |
    |--------|-------------|----------|-----------|
    | Hot/trending tokens | `npx @chainstream-io/cli market trending --chain sol --duration 1h` | `market_trending` | [market-discovery.md](references/market-discovery.md) |
    | New token listings | `npx @chainstream-io/cli market new --chain sol` | `market_trending` | [market-discovery.md](references/market-discovery.md) |
    | Recent trades | `npx @chainstream-io/cli market trades --chain sol` | `trades_recent` | [market-discovery.md](references/market-discovery.md) |
    
    ### Wallet
    
    | Intent | CLI Command | MCP Tool | Reference |
    |--------|-------------|----------|-----------|
    | Wallet profile (PnL + holdings) | `npx @chainstream-io/cli wallet profile --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references/wallet-profiling.md) |
    | PnL details | `npx @chainstream-io/cli wallet pnl --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references/wallet-profiling.md) |
    | Token balances | `npx @chainstream-io/cli wallet holdings --chain sol --address ADDR` | `wallets_profile` | [wallet-profiling.md](references/wallet-profiling.md) |
    | Transfer history | `npx @chainstream-io/cli wallet activity --chain sol --address ADDR` | `walle
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/chainstream-io-skills-chainstream-data.md

// REPO STATS

1 stars
0 open issues
Last commit: 3mo ago