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

> Send MCP Toolbox traces to Agnost over OTLP

MCP Toolbox emits OTLP spans natively. Pass the Agnost endpoint and your org ID via env var.

<Note>
  MCP Toolbox traces can include tool names, tool parameters, SQL/tool results, and errors. Review [Data Governance](/data-governance) before enabling production traffic.
</Note>

## Setup

```bash theme={null}
export OTEL_EXPORTER_OTLP_HEADERS="X-Agnost-Org-ID=<your-org-id>"
./toolbox --tools-file tools.yaml --telemetry-otlp="otel.agnost.ai"
```

See the [MCP Toolbox guide](/mcp-toolbox) for full setup details.

## Verify

Call one Toolbox tool, then open **Raw logs** and **Tools** in Agnost.

## Troubleshooting

* Confirm `--telemetry-otlp="otel.agnost.ai"` is passed to Toolbox.
* Confirm `OTEL_EXPORTER_OTLP_HEADERS` contains `X-Agnost-Org-ID=<your-org-id>`.
* If SQL or tool results are sensitive, scrub or disable those attributes before production rollout.

## References

* [Enable OpenTelemetry export](https://mcp-toolbox.dev/documentation/monitoring/export_telemetry/)
* [Add custom metadata](https://mcp-toolbox.dev/documentation/monitoring/export_telemetry/#running-the-collector)
