Skip to main content
The SQD plugin connects Codex to blockchain data across 130+ networks through the hosted Portal MCP server. MCP query tools cover EVM networks, Solana, Polkadot and other Substrate networks, Bitcoin, and Hyperliquid. Tron discovery, head, freshness, and timestamp lookups are available through MCP, while the bundled Portal skill documents native Tron Stream API queries. The package adds 28 read-only MCP tools plus four skills for Portal, Pipes SDK, and Squid SDK projects.
Before you start: install the Codex CLI. Run the install commands below in your terminal, not inside a Codex task.

Install

1

Add the SQD plugin marketplace

A marketplace is a catalog of plugins. This command pulls SQD’s catalog straight from GitHub so the next step can install from it. No clone needed.
2

Install the Portal plugin

Codex installs plugins with add (not install).
3

Confirm the plugin is active

You should see portal@sqd listed as installed, enabled.
4

Start a new Codex task

Codex loads bundled skills and MCP servers when a task starts. Start a new task, then ask one of the questions below.If Codex asks you to approve an SQD MCP tool call, allow it to run. The hosted endpoint does not require an API key or sign-in.

What gets added

Try it

Start with a direct request:
  • “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, Codex 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 Codex only explains how to fetch the data, start a new task and check codex plugin list.

Troubleshooting

  • portal@sqd not found: confirm the marketplace add command finished without errors, then rerun codex plugin add portal@sqd. To refresh the catalog later, run codex plugin marketplace upgrade sqd.
  • Tools or skills do not appear: start a new Codex task so it loads the plugin bundle.
  • A tool call was cancelled: run the prompt again and approve the SQD MCP tool when Codex asks.
  • Prefer manual setup: configure the endpoint by hand from the Portal MCP Server page instead.