Release / 27 Mar 2026

MCP Toolbox for Databases v0.31.0

Authenticate MCP clients with a generic authorization service.

Before you upgrade to v0.31.0

3 to fix

Use `/mcp`, or explicitly enable the legacy `/api` endpoint with `--enable-api`; it is now disabled by default.

Action requiredDefine parameterized database tools in YAML and share them with agents through MCP or Toolbox SDKs.Affects: SDKs or custom clients using the native Toolbox API.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Replace `--tools_file` with `--config`; migrate deprecated `--tools-file`, `--tools-files`, and `--tools-folder` to `--config`, `--configs`, and `--config-folder`.

Action requiredDefine parameterized database tools in YAML and share them with agents through MCP or Toolbox SDKs.Affects: Deployment scripts using old configuration flags.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Use singular flat-format kinds such as `source` and `tool`; replace `authSources` with supported auth-service configuration and remove Cloud SQL SQL Server `ipAddress`.

Action requiredDefine parameterized database tools in YAML and share them with agents through MCP or Toolbox SDKs.Affects: Configurations using plural flat kinds, legacy authSources, or Cloud SQL SQL Server ipAddress.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Non-2xx errors return sanitized output instead of the original upstream error content.

Behavior changedCall HTTP APIs through configured tools.Affects: Clients consuming HTTP tool errors.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

What changed in v0.31.0

Adds generic MCP authorization and disables the legacy API by default; configuration names and CLI flags change.

v0.31.0; use the release binaries or container image and configure the required source credentials. Beta release; the public API can change.

New things you can do

Authenticate MCP access with a generic authorization service and Protected Resource Metadata.

Added

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Fixed and improved

Retrieve catalog context with the lookup-context tool.

ImprovedDiscover data assets through Dataplex catalog tools.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Parse integer parameters correctly in generated agent skills.

Now worksGenerate Agent Skills from configured toolsets.

Read the evidence

googleapis/mcp-toolbox/releases/tag/v0.31.0

Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.