> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills Installation

> Install ChainStream Agent Skills on Cursor, Claude Code, ClawHub, and more

## Installation Methods

ChainStream skills can be installed through multiple channels depending on your agent platform. The `npx skills add` route is the fastest — one command, works across Cursor, Claude Code, Codex, OpenCode and OpenClaw.

| Method                                                        | What it does                                                                    | Setup Time   |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------ |
| [`npx skills add` (recommended)](#npx-skills-add-recommended) | Cross-platform installer: adds all three ChainStream skills to the target agent | \~20 seconds |
| [ClawHub](#clawhub)                                           | Marketplace install via `openclaw skills install`                               | \~30 seconds |
| [Cursor](#cursor)                                             | Clone repo + `.cursor-plugin/` auto-discovery                                   | \~1 minute   |
| [Claude Code](#claude-code)                                   | `/plugin install chainstream`                                                   | \~30 seconds |
| [Codex](#codex)                                               | Git clone + symlink into `~/.agents/skills/`                                    | \~1 minute   |
| [OpenCode](#opencode)                                         | Git clone + symlink into `~/.agents/skills/`                                    | \~1 minute   |
| [Gemini CLI](#gemini-cli)                                     | `gemini extensions install`                                                     | \~30 seconds |

***

## `npx skills add` (recommended)

A single command installs all three ChainStream skills (`chainstream-data`, `chainstream-graphql`, `chainstream-defi`) into the target agent. Use `-a <agent>` to pick which agent to install into.

<Tabs>
  <Tab title="Cursor">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a cursor
    ```
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a claude-code
    ```
  </Tab>

  <Tab title="OpenClaw">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a openclaw
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a codex
    ```
  </Tab>

  <Tab title="OpenCode">
    ```bash theme={null}
    npx skills add chainstream-io/skills -a opencode
    ```
  </Tab>
</Tabs>

After install, configure the API Key so the CLI and MCP tools work:

```bash theme={null}
npx @chainstream-io/cli login                               # create wallet + get nano trial (50K CU)
# or, if you already have a key:
npx @chainstream-io/cli config set --key apiKey --value <your-api-key>
```

<Note>
  `npx skills add` pulls the latest version of the skills on every run, so re-running it also updates. See the full OpenClaw install flow (skill verification, multi-agent targeting) in [Ecosystem → OpenClaw → Skills Install](/en/docs/ecosystem/openclaw/skills-install).
</Note>

***

## ClawHub

ChainStream skills are published on [ClawHub](https://clawhub.ai), the OpenClaw skill marketplace.

| Skill               | ClawHub URL                                                              | Version |
| ------------------- | ------------------------------------------------------------------------ | ------- |
| chainstream-data    | [clawhub.ai/chainstream-data](https://clawhub.ai/chainstream-data)       | Latest  |
| chainstream-graphql | [clawhub.ai/chainstream-graphql](https://clawhub.ai/chainstream-graphql) | Latest  |
| chainstream-defi    | [clawhub.ai/chainstream-defi](https://clawhub.ai/chainstream-defi)       | Latest  |

```bash theme={null}
# Install via ClawHub CLI
openclaw skills install chainstream-data
openclaw skills install chainstream-graphql
openclaw skills install chainstream-defi
```

Or install from the ClawHub web UI — click **Install** on the skill page and follow the instructions.

***

## Cursor

Skills are automatically discovered via the `.cursor-plugin/plugin.json` configuration included in the skills repository.

<Steps>
  <Step title="Clone the skills repo">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git
    ```
  </Step>

  <Step title="Open in Cursor">
    Open the cloned `skills/` directory in Cursor. The `.cursor-plugin/plugin.json` tells Cursor to load the skills automatically.
  </Step>

  <Step title="Configure API Key">
    Set your API Key for CLI and MCP access:

    ```bash theme={null}
    npx @chainstream-io/cli config set --key apiKey --value <your-api-key>
    ```
  </Step>

  <Step title="Start using">
    Ask your AI assistant:

    ```
    search for meme tokens on Solana
    is <token_address> safe to buy?
    swap 0.1 SOL for <token_address>
    ```
  </Step>
</Steps>

<Note>
  Cursor will also publish ChainStream as a marketplace plugin. Once available, you can install directly from Cursor Settings > Extensions.
</Note>

***

## Claude Code

```bash theme={null}
/plugin install chainstream
```

The `.claude-plugin/plugin.json` in the skills repo provides the plugin metadata for Claude Code.

<Note>
  Claude Code marketplace plugin is coming soon. Once published, install directly from the Claude Code plugin store.
</Note>

***

## Codex

<Steps>
  <Step title="Clone the repo">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git ~/.agents/skills/chainstream
    ```
  </Step>

  <Step title="Follow setup">
    See the instructions in `.codex/INSTALL.md` within the cloned repo.
  </Step>
</Steps>

***

## OpenCode

<Steps>
  <Step title="Clone the repo">
    ```bash theme={null}
    git clone https://github.com/chainstream-io/skills.git ~/.agents/skills/chainstream
    ```
  </Step>

  <Step title="Follow setup">
    See the instructions in `.opencode/INSTALL.md` within the cloned repo.
  </Step>
</Steps>

***

## Gemini CLI

```bash theme={null}
gemini extensions install https://github.com/chainstream-io/skills
```

The `gemini-extension.json` in the repo root configures Gemini CLI to load the context file.

***

## MCP Server Configuration

Skills work best when paired with the ChainStream MCP Server. Add this to your MCP client configuration:

<Tabs>
  <Tab title="Cursor / VS Code">
    ```json theme={null}
    {
      "mcpServers": {
        "chainstream": {
          "url": "https://mcp.chainstream.io/mcp",
          "headers": { "X-API-KEY": "<your-api-key>" }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

    ```json theme={null}
    {
      "mcpServers": {
        "chainstream": {
          "url": "https://mcp.chainstream.io/mcp",
          "headers": { "X-API-KEY": "<your-api-key>" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Note>
  Get your API Key from [ChainStream Dashboard](https://app.chainstream.io) or via [x402 / MPP payment](/en/docs/platform/billing-payments/x402-payments).
</Note>

***

## Verify Installation

After installation, test with a simple query:

```bash theme={null}
# Via CLI
npx @chainstream-io/cli token search --keyword PUMP --chain sol

# Via AI assistant (if skills are loaded)
# Ask: "search for PUMP tokens on Solana"
```

## Next Steps

<CardGroup cols={2}>
  <Card title="chainstream-data" icon="magnifying-glass" href="/en/docs/ai-agents/agent-skills/chainstream-data">
    Data queries: token, market, wallet
  </Card>

  <Card title="chainstream-graphql" icon="diagram-project" href="/en/docs/ai-agents/agent-skills/chainstream-graphql">
    Custom GraphQL analytics and JOINs
  </Card>

  <Card title="chainstream-defi" icon="right-left" href="/en/docs/ai-agents/agent-skills/chainstream-defi">
    DeFi execution: swap, launchpad, transaction
  </Card>

  <Card title="OpenClaw Skills Install" icon="cube" href="/en/docs/ecosystem/openclaw/skills-install">
    Full `npx skills` flags and multi-agent targeting
  </Card>
</CardGroup>
