# MCP Toolbox for Databases

> Add Voxmith analytics to Google's MCP Toolbox for Databases

## Prerequisites

* [MCP Toolbox](https://github.com/googleapis/genai-toolbox) installed
* A `tools.yaml` configuration file for your toolbox setup

## Installation

First, check the current version:

```bash theme={null}
./toolbox version
```

Choose your preferred installation method:

<Tabs>
  <Tab title="Binary">
    ```bash theme={null}
    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
    ```
  </Tab>

  <Tab title="Docker">
    ```bash theme={null}
    export VERSION=0.28.0  # or your preferred version
    docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install mcp-toolbox
    ```
  </Tab>
</Tabs>

## 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:

```dotenv theme={null}
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:

```bash theme={null}
./toolbox \
  --tools-file "tools.yaml" \
  --telemetry-otlp="otel.voxmith.com"
```

Replace `<your-voxmith-org-id>` with the organization ID from your
[Voxmith dashboard](https://app.voxmith.com).

### Docker Usage

If using Docker:

```bash theme={null}
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](https://app.voxmith.com) 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?

* Check your [dashboard](https://app.voxmith.com) for incoming data
* Contact us at [founders@www.voxmith.com](mailto:founders@www.voxmith.com) if you need assistance

## MCP Toolbox Support Resources

* Visit the [MCP Toolbox documentation](https://mcp-toolbox.dev/documentation/getting-started/) for detailed guides

## Next steps

* [Tool calls](/using-tool-calls): analyze Toolbox usage, outcomes, and latency.
* [Events](/using-events): inspect the exported OpenTelemetry records.
* [Alerts](/using-alerts): monitor important tool conditions.