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

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 140+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> Every page on this site is available as Markdown by appending .md to its URL.

# SQD extension for Gemini CLI

> Install SQD in Gemini CLI with blockchain data tools and four official SQD skills.

The SQD extension connects Gemini CLI to blockchain data across 140+ networks through the hosted Portal MCP server. Coverage includes Ethereum, Base, Solana, Polkadot, Bitcoin, Tron, Hyperliquid, and many more networks. The extension adds 28 read-only MCP tools plus four skills for Portal, Pipes SDK, and Squid SDK projects.

<Note>
  **Before you start:** install [Gemini CLI](https://github.com/google-gemini/gemini-cli). Run the install commands below in your terminal, not inside a Gemini session.
</Note>

## Install

<Steps>
  <Step title="Install SQD from GitHub">
    ```bash theme={"system"}
    gemini extensions install https://github.com/subsquid-labs/portal-mcp-server
    ```

    No SQD account, API key, or extension setting is required.
  </Step>

  <Step title="Confirm the extension is active">
    ```bash theme={"system"}
    gemini extensions list
    ```

    You should see `sqd` version `0.8.1`.
  </Step>

  <Step title="Start a new Gemini session">
    Gemini loads extensions when a session starts. Start a new session, then run `/extensions list` to confirm SQD is enabled.
  </Step>
</Steps>

<Tip>
  Direct installation from GitHub works while the Gemini CLI extension gallery completes its automatic indexing.
</Tip>

## What gets added

| Field             | Value                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------- |
| Extension name    | `sqd`                                                                                 |
| Display name      | `SQD`                                                                                 |
| Extension version | `0.8.1`                                                                               |
| MCP server name   | `SQD`                                                                                 |
| MCP endpoint      | `https://portal.sqd.dev/mcp`                                                          |
| Bundled skills    | `portal`, `pipes-sdk`, `migrate-to-portal`, `squid-perf`                              |
| Authentication    | None for the public server                                                            |
| Source            | [subsquid-labs/portal-mcp-server](https://github.com/subsquid-labs/portal-mcp-server) |

## Try it

* "Show me the last 200 BTC perp fills on Hyperliquid."
* "How many transactions landed on Base in the past 2h?"
* "Show me the latest 20 USDC transfers on Base from the past hour."
* "Track USDT transfers on Tron."
* "Migrate this Squid SDK project from the v2 gateway to Portal."
* "Build a Pipes SDK indexer for USDC transfers on Ethereum."

For a bounded data question, Gemini should call a `portal_` tool and return query results. The bundled Portal skill handles raw exports, including data shapes not exposed as a dedicated MCP tool. The other skills help build Pipes SDK indexers, migrate Squid SDK projects, and compare Squid sync performance.

## Troubleshooting

* **`sqd` does not install:** confirm `git` is installed, then run the install command again outside an active Gemini session.
* **Tools or skills do not appear:** restart Gemini CLI and run `/extensions list`.
* **Update an existing install:** run `gemini extensions update sqd`, then restart Gemini CLI.
* **Prefer manual MCP setup:** configure the endpoint from the [Portal MCP Server](/en/ai/mcp-server) page instead.

## Related

* [Claude Code Plugin](/en/ai/plugins-claude). Install SQD in Claude Code
* [Codex Plugin](/en/ai/plugins-codex). Install SQD in Codex
* [Grok Plugin](/en/ai/plugins-grok). Install SQD in Grok
* [Cursor Plugin](/en/ai/plugins-cursor). Install SQD in Cursor
* [Portal MCP Server](/en/ai/mcp-server). Manual MCP setup and tool reference
* [Agent Skills](/en/ai/agent-skills). Install SQD skills without the extension


## Related topics

- [SQD plugin for Cursor](/en/ai/plugins-cursor.md)
- [AI Development](/en/ai/ai-development.md)
- [Portal MCP Server for AI Agents](/en/ai/mcp-server.md)
- [CLI Installation](/en/cloud/reference/cli/installation.md)
- [CLI Cheatsheet](/en/sdk/squid-sdk/solana/guides/advanced/cli-cheatsheet.md)