Skip to main content

Use with Codex

SignalPilot ships a Codex plugin that mirrors the Claude Code plugin: the same 40 MCP tools, 23 skills, and 2 agents. The plugin marketplace repo is SignalPilot-Labs/codex-signalpilot-plugin (distinct from the Claude Code signalpilot-plugin).

Prerequisites​

  • Codex installed and working
  • SignalPilot MCP server connected (see Connecting below)

Install​

install the codex plugin
$ codex plugin marketplace add SignalPilot-Labs/codex-signalpilot-plugin
$ codex plugin add signalpilot@signalpilot

The first command registers the plugin marketplace source. The second installs the signalpilot plugin.

If install fails on a stale marketplace snapshot​

If a broken marketplace snapshot was added, upgrade it before adding the plugin:

upgrade marketplace and add plugin
$ codex plugin marketplace upgrade signalpilot
$ codex plugin add signalpilot@signalpilot

What it adds​

  • 40 MCP tools — query_database, list_tables, dbt_error_parser, schema discovery, governance, and more.
  • 23 skills — the full dbt and SQL skill set (dbt-workflow, dbt-write, sql-workflow, dialect skills, domain skills).
  • 2 agents — verifier (post-build 7-check protocol) and value-verifier (aggregate value checks).

Skills and agents behave the same as on Claude Code — same loading conditions, same orchestration.

Connect the MCP server​

Connecting the MCP server is identical to Claude Code: streamable-http to the gateway.

Local gateway:

local mcp endpoint
http://localhost:3300/mcp

SignalPilot Cloud (bearer auth):

cloud mcp endpoint
https://gateway.signalpilot.ai/mcp
Authorization: Bearer YOUR_API_KEY

For local self-hosted deployments without API key enforcement, no auth header is required.

Update​

update the codex plugin
$ codex plugin marketplace upgrade signalpilot

See also​