Documentation
MCP Tools Reference
BridgeDB exposes three MCP tools that let Claude query your databases. All queries are read-only by default for safety.
Quick Start
Add this to your claude_desktop_config.json:
JSON
{
"mcpServers": {
"bridgedb": {
"url": "https://bridgedb-landing.vercel.app/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Get your API key from the MCP dashboard.
Or for Claude Code, run this command:
Terminal
npx @anthropic-ai/claude-code mcp add-json bridgedb '{"type":"http","url":"https://bridgedb-landing.vercel.app/api/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'Available Tools
bridgedb.query
Execute a read-only SQL query against your connected database.
Parameters
sqlstringrequiredThe SQL query to execute
Example
Input
{
"sql": "SELECT name, email FROM users WHERE created_at > '2024-01-01' LIMIT 10"
}Output
{
"rows": [
{ "name": "Alice Chen", "email": "alice@example.com" },
{ "name": "Bob Smith", "email": "bob@example.com" }
],
"rowCount": 2,
"duration": "42ms"
}bridgedb.list_tables
List all tables and views in the connected database with row counts.
Example
Input
{}Output
{
"tables": [
{ "name": "users", "type": "table", "rowCount": 1542 },
{ "name": "orders", "type": "table", "rowCount": 8234 },
{ "name": "products", "type": "table", "rowCount": 156 },
{ "name": "order_summary", "type": "view", "rowCount": null }
]
}bridgedb.describe_table
Get the schema of a specific table including column names, types, and constraints.
Parameters
tablestringrequiredThe name of the table to describe
Example
Input
{
"table": "users"
}Output
{
"table": "users",
"columns": [
{ "name": "id", "type": "uuid", "nullable": false, "primaryKey": true },
{ "name": "email", "type": "text", "nullable": false, "unique": true },
{ "name": "name", "type": "text", "nullable": true },
{ "name": "created_at", "type": "timestamptz", "nullable": false }
]
}Supported Databases
PostgreSQL
Version 12+
MySQL
Version 8.0+
Firestore
Version Latest
Security
Read-only by default
All connections are read-only unless explicitly enabled for writes.
AES-256 encryption
Connection strings are encrypted at rest.
No data storage
Query results are streamed directly to Claude, never stored on our servers.
API key rotation
Rotate your API keys anytime from the dashboard.