Skip to main content
Most behavior is controlled by the action’s dedicated inputs. For anything not exposed as an input, ironbee_extra_config is a raw JSON escape hatch: it’s deep-merged into the generated .ironbee/config.json, and your keys win over the defaults.

How it works

Pass a JSON object as a string. It’s merged on top of the config the action generates, so you only specify the keys you want to change:
- uses: ironbee-ai/ironbee-action@v1
  with:
    ironbee_api_key: ${{ secrets.IRONBEE_API_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    ironbee_extra_config: |
      {
        "verification": { "enable": true },
        "browserDevTools": { "env": { "LOG_FILE": "/tmp/browser-devtools.log" } }
      }
This accepts any key from the IronBee CLI config, see the CLI configuration reference for the full set.

Tuning a verification platform

Each verification platform’s MCP server is customized under browserDevTools, backendDevTools, or nodeDevTools. Set extra environment variables or replace the server entirely:
- uses: ironbee-ai/ironbee-action@v1
  with:
    ironbee_api_key: ${{ secrets.IRONBEE_API_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    ironbee_extra_config: |
      {
        "browserDevTools": { "env": { "BROWSER_HEADLESS_ENABLE": "true" } }
      }
See the CLI’s DevTools MCP overrides for the full set of keys each platform accepts.
IronBee always sets its own invariants (tool-name prefix, metadata flags, platform) last, these can’t be overridden via ironbee_extra_config.

What’s next?

Verification platforms

The browser, backend, and Node.js platforms you’re tuning.

All configuration options

Every input and output, with defaults.