MCP Toolbox for Databases

​

Prerequisites

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

​

Installation

./toolbox version

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

export VERSION=0.28.0  # or your preferred version
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION

brew install mcp-toolbox

​

Enable Telemetry

OTEL_EXPORTER_OTLP_HEADERS="X-Agnost-Org-ID=<your-agnost-org-id>"

./toolbox \
  --tools-file "tools.yaml" \
  --telemetry-otlp="otel.agnost.ai"

​

Docker Usage

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!

• 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

​

Troubleshooting

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

​

Need Help?

• Check your dashboard for incoming data
• Contact us at [email protected] if you need assistance
• Book a call for personalized setup support

​

MCP Toolbox Support Resources

• Visit the MCP Toolbox documentation for detailed guides

​

Next steps

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