Skip to main content

Use with Codex

SignalPilot ships a Codex plugin that mirrors the Claude Code plugin: the same 62 MCP tools, 24 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​

  • 62 MCP tools — query_database, list_tables, dbt_error_parser, schema discovery, governance, and more.
  • 24 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​

Add SignalPilot to ~/.codex/config.toml. Create the key first under Settings → API Keys in SignalPilot; it starts with sp_ and is shown once.

~/.codex/config.toml
[mcp_servers.signalpilot]
url = "https://gateway.signalpilot.ai/mcp"
http_headers = { "x-api-key" = "sp_your_key_here" }

Restart Codex, then ask it to list the SignalPilot tools to confirm the connection.

:::note Self-hosted gateway If you run SignalPilot yourself, use your own endpoint instead, typically http://localhost:3300/mcp. A fresh self-hosted gateway needs no header until the first API key is created; after that, add the same http_headers line. :::

Update​

update the codex plugin
$ codex plugin marketplace upgrade signalpilot

See also​