> ## 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 plugin for Grok

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

The SQD plugin connects Grok Build 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 package adds 28 read-only MCP tools plus four skills for Portal, Pipes SDK, and Squid SDK projects.

<Note>
  **Before you start:** install [Grok Build](https://docs.x.ai/build/overview). Run the install commands below in your terminal, not inside a Grok session.
</Note>

<Tip>
  Using Grok on the web instead? Open [Grok Connectors](https://grok.com/connectors), select **New Connector**, choose **Custom**, and enter `https://portal.sqd.dev/mcp` as the MCP server URL. Name the connector **SQD**. No sign-in or API key is required. The custom connector provides the 28 MCP tools, while the Grok Build plugin also includes the four coding skills.
</Tip>

## Install

<Steps>
  <Step title="Add the SQD plugin marketplace">
    A marketplace is a catalog of plugins. This command registers SQD's catalog directly from the official GitHub repository.

    ```bash theme={"system"}
    grok plugin marketplace add subsquid-labs/portal-mcp-server
    ```
  </Step>

  <Step title="Install the Portal plugin">
    ```bash theme={"system"}
    grok plugin install portal --trust
    ```

    `--trust` allows the plugin to connect its hosted MCP server. Only use it with the official `subsquid-labs/portal-mcp-server` source shown above.
  </Step>

  <Step title="Confirm the plugin is active">
    ```bash theme={"system"}
    grok plugin list
    grok inspect
    ```

    `grok plugin list` should show `portal` version `0.8.0`. In `grok inspect`, the `SQD` MCP server should point to `https://portal.sqd.dev/mcp` and the four bundled skills should appear under the `portal` plugin.
  </Step>

  <Step title="Start a new Grok session">
    Grok loads bundled skills and MCP servers when a session starts. Start a new session, then ask one of the questions below. If Grok is already open, use `/plugins` and press `r` to reload plugins.
  </Step>
</Steps>

## What gets added

| Field           | Value                                                                                 |
| --------------- | ------------------------------------------------------------------------------------- |
| Plugin name     | `portal`                                                                              |
| Display name    | `SQD`                                                                                 |
| Plugin version  | `0.8.0`                                                                               |
| 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

Start with a direct request:

* "Which blockchain networks can SQD query?"
* "Show me up to 200 BTC perp fills on Hyperliquid from the past hour."
* "How many transactions landed on Base in the past 2h?"
* "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, Grok 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. If Grok only explains how to fetch the data, start a new session and run `grok inspect` to confirm the plugin and MCP server are loaded.

## MCP only

If you want the 28 blockchain data tools without the four coding skills, add the hosted server directly:

```bash theme={"system"}
grok mcp add --transport http SQD https://portal.sqd.dev/mcp
```

Check the connection with:

```bash theme={"system"}
grok mcp doctor SQD
```

## Troubleshooting

* **`portal` not found:** confirm the marketplace command completed, then run `grok plugin marketplace update portal-mcp-server` and retry the install.
* **Plugin installed but tools are missing:** start a new Grok session or use `/plugins` and press `r`. Run `grok inspect` to confirm the `SQD` server comes from `plugin: portal`.
* **MCP server is blocked:** reinstall the plugin with `grok plugin install portal --trust` so Grok can load its MCP server.
* **Connection fails:** run `grok mcp doctor SQD` and confirm the target is `https://portal.sqd.dev/mcp`.
* **Prefer manual setup:** add 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
* [Portal MCP Server](/en/ai/mcp-server). Manual MCP setup and tool reference
* [Agent Skills](/en/ai/agent-skills). Install SQD skills without the plugin
* [AI Development Overview](/en/ai/ai-development). SQD resources for AI agents


## Related topics

- [Portal MCP Server for AI Agents](/en/ai/mcp-server.md)
- [SQD plugin for Codex](/en/ai/plugins-codex.md)
- [SQD plugin for Claude Code](/en/ai/plugins-claude.md)
- [AI Development](/en/ai/ai-development.md)
- [ApeWorx plugin](/en/sdk/alternative-clients/apeworx.md)