Before you start: install Grok Build. Run the install commands below in your terminal, not inside a Grok session.
Install
1
Add the SQD plugin marketplace
A marketplace is a catalog of plugins. This command registers SQD’s catalog directly from the official GitHub repository.
2
Install the Portal plugin
--trust allows the plugin to connect its hosted MCP server. Only use it with the official subsquid-labs/portal-mcp-server source shown above.3
Confirm the plugin is active
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.4
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.What gets added
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.”
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:Troubleshooting
portalnot found: confirm the marketplace command completed, then rungrok plugin marketplace update portal-mcp-serverand retry the install.- Plugin installed but tools are missing: start a new Grok session or use
/pluginsand pressr. Rungrok inspectto confirm theSQDserver comes fromplugin: portal. - MCP server is blocked: reinstall the plugin with
grok plugin install portal --trustso Grok can load its MCP server. - Connection fails: run
grok mcp doctor SQDand confirm the target ishttps://portal.sqd.dev/mcp. - Prefer manual setup: add the endpoint from the Portal MCP Server page instead.
Related
- Claude Code Plugin. Install SQD in Claude Code
- Codex Plugin. Install SQD in Codex
- Portal MCP Server. Manual MCP setup and tool reference
- Agent Skills. Install SQD skills without the plugin
- AI Development Overview. SQD resources for AI agents