TDB Enterprise¶
The Data-Bridge is a self-hosted, auditable API layer that turns your databases into secure REST and MCP endpoints — governed, queryable, and AI-ready.
Register a data source once. Query it from REST, SQL, or any MCP-compatible AI tool. Every query is logged.
Your data is already scattered across PostgreSQL, MySQL, SQL Server, Snowflake, and CSV files — and every team now wants AI agents to query it. TDB makes that existing, multi-source data safely accessible on your own infrastructure, without moving it into a single cloud warehouse or routing it through a SaaS copilot, and with a tamper-evident audit log you own. → Why TDB
Features¶
Connectors
- PostgreSQL, MySQL, SQL Server, and Snowflake connectors
- Database-wide or single-table registration per source
- Multiple simultaneous registered sources
Auth & API
- Static API keys, plus DB-managed keys (create / rotate / revoke)
- Role-based access control (read / readwrite / admin)
- JWT authentication
- OAuth 2.1 with PKCE on MCP
- Per-API-key rate limiting
- CORS configuration
Query & MCP
- REST query endpoint (SELECT only)
- MCP tools:
query_source,schema_source,preview_source,filter_source,aggregate_source,list_views,run_view - YAML-defined named views with typed parameters
- Prompt-injection filtering (input + output)
- MCP tool-level allow-lists per API key
- Auto schema detection
Audit & Compliance
- Audit log (NDJSON) on every query
- Signed, hash-chained audit log (tamper-evident), with integrity verification via
GET /v1/audit/verify - Splunk HEC export via
POST /v1/audit/export
Observability
- Prometheus metrics (
GET /metrics) - Schema caching with configurable TTL
- Health check (
GET /health)
How it works¶
Postgres · MySQL · SQL Server · Snowflake
│
│ read-only connection (per connector)
▼
┌────────────────────────────────────────────┐
│ TDB Enterprise │
│ │
│ POST /v1/sources ← register source │
│ POST /v1/query ← SQL SELECT │
│ POST /v1/mcp ← MCP tool calls │
│ GET /v1/views ← YAML-defined views │
│ GET /metrics ← Prometheus │
│ │
│ Every query → hash-chained audit log │
│ RBAC enforced per key (read/readwrite/ │
│ admin); tool allow-lists per MCP key │
└────────────────────────────────────────────┘
│
│ Authorization: Bearer <token>
▼
Your app / Claude Desktop / Cursor
TDB never modifies your data. Every connector enforces read-only access at the connection or session level — not just SQL-validated.
Quick links¶
- Installation →
- Quickstart — first query in 5 minutes →
- PostgreSQL → · MySQL → · SQL Server → · Snowflake →
- Authentication overview →
- Role-based access control →
- Audit log & tamper verification →
- YAML named views →
- Prometheus metrics →
- Splunk HEC integration →
- All environment variables →
- Editions & feature comparison →
Interactive API docs¶
When TDB is running, the full OpenAPI reference is available at:
- Swagger UI —
http://localhost:8000/docs - ReDoc —
http://localhost:8000/redoc - OpenAPI JSON —
http://localhost:8000/openapi.json