Skip to main content
The SQD plugin connects Codex 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.
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:
  • “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, 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.

Related topics

Portal MCP Server for AI AgentsSQD plugin for GrokSQD plugin for Claude CodeAI DevelopmentApeWorx plugin