Get Started
Platforms

MCP Toolbox for Databases

Add Voxmith analytics to Google's MCP Toolbox for Databases

Prerequisites

  • MCP Toolbox installed
  • A tools.yaml configuration file for your toolbox setup

Installation

First, check the current version:

./toolbox version

Choose your preferred installation method:

export VERSION=0.28.0  # or your preferred version
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

Enable Telemetry

Set this environment variable before running the server. Use whichever mechanism your environment provides, such as a shell configuration, .env file, container configuration, or deployment-platform settings:

OTEL_EXPORTER_OTLP_HEADERS="X-Voxmith-Org-ID=<your-voxmith-org-id>"

Then run your MCP Toolbox with telemetry enabled and point it to Voxmith:

./toolbox \
  --tools-file "tools.yaml" \
  --telemetry-otlp="otel.voxmith.com"

Replace <your-voxmith-org-id> with the organization ID from your Voxmith dashboard.

Docker Usage

If using Docker:

docker run \
  -e OTEL_EXPORTER_OTLP_HEADERS="X-Voxmith-Org-ID=<your-voxmith-org-id>" \
  -v $(pwd)/tools.yaml:/app/tools.yaml \
  us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION \
  --tools-file "/app/tools.yaml" \
  --telemetry-otlp="otel.voxmith.com"

That's It!

Your MCP Toolbox is now sending telemetry data to Voxmith. Visit your Voxmith dashboard to:

  • Monitor tool invocations in real-time
  • Track performance metrics and response times
  • Analyze usage patterns and optimization opportunities
  • Set up alerts for performance issues

Verify

Call one Toolbox tool, then open Events and Tool calls in Voxmith. You should see the tool name, latency, success/failure, and exported metadata.

Troubleshooting

  • Confirm OTEL_EXPORTER_OTLP_HEADERS contains X-Voxmith-Org-ID=<your-voxmith-org-id>.
  • Confirm Toolbox is started with --telemetry-otlp="otel.voxmith.com".
  • If running Docker, confirm the env var is passed into the container.

Need Help?

MCP Toolbox Support Resources

Next steps

  • Tool calls: analyze Toolbox usage, outcomes, and latency.
  • Events: inspect the exported OpenTelemetry records.
  • Alerts: monitor important tool conditions.