> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agnost.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Toolbox for Databases

> Add Agnost AI 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 your Agnost organization ID as an environment variable before running the server:

```bash theme={null}
export OTEL_EXPORTER_OTLP_HEADERS="X-Agnost-Org-ID=<your-agnost-org-id>"
```

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

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

<Note>
  Replace `<your-agnost-org-id>` with your organization ID from your [Agnost AI dashboard](https://app.agnost.ai). You can set `OTEL_EXPORTER_OTLP_HEADERS` in your shell profile or environment configuration so it persists across sessions.
</Note>

### Docker Usage

If using Docker:

```bash theme={null}
docker run \
  -e OTEL_EXPORTER_OTLP_HEADERS="X-Agnost-Org-ID=<your-agnost-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.agnost.ai"
```

## That's It!

Your MCP Toolbox is now sending telemetry data to Agnost AI. Visit your [Agnost AI dashboard](https://app.agnost.ai) 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

## Need Help?

* Check your [dashboard](https://app.agnost.ai) for incoming data
* Contact us at [founders@agnost.ai](mailto:founders@agnost.ai) if you need assistance
* [Book a call](https://call.agnost.ai/) for personalized setup support

## MCP Toolbox Support Resources

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