MotherDuck MCP

Live

OAUTH 2.0

DATABASES

Developer Tools

Connect to MotherDuck MCP. Query and analyze DuckDB databases, explore schemas, create visualizations, and automate data workflows from your AI workflows.

  • Acts as the user: Every tool call runs as the authorizing user. Access and audit trail stay intact.
  • Credentials stay vaulted: AES-256 encrypted, resolved at request time, never stored in LLM context.
  • Scoped before every call: Per-user permissions enforced automatically. 90-day audit trail included.
MotherDuck MCP
agent · Acme Q3
Run
Ask Docs Question in MotherDuck MCP
S
motherduckmcp_ask_docs_question
85ms
MotherDuck MCP agent
Query official duckdb and motherduck documentation to answer questions about sql syntax, features, and best practices..
Sources: MotherDuck MCP
motherduckmcpmcp
1 tool call
18:29
Message Claude...

MotherDuck MCP tools for AI agents

CALL ANY TOOL
12 tools covering ask, create, cancel.
motherduckmcp_list_dives
List dives
Return all Dives owned in the MotherDuck workspace, including metadata like version history and timestamps. Optionally filter by keywords.
Parameters
Name
Type
Required
Description
keywords
string
Optional
Keywords to filter by title/description (case-insensitive, all words must match).
motherduckmcp_search_catalog
Search catalog
motherduckmcp_list_views
List views
motherduckmcp_get_guide
Get guide
motherduckmcp_list_guides
List guides
motherduckmcp_get_flight
Get flight
motherduckmcp_list_macros
List macros
motherduckmcp_get_dive_guide
Get dive guide
motherduckmcp_list_shares
List shares
motherduckmcp_get_flight_logs
Get flight logs
motherduckmcp_list_tables
List tables
motherduckmcp_get_query_guide
Get query guide
motherduckmcp_list_columns
List columns
motherduckmcp_get_flight_guide
Get flight guide
motherduckmcp_list_flights
List flights
motherduckmcp_get_flight_run_logs
Get flight run logs
motherduckmcp_list_databases
List databases
motherduckmcp_get_short_lived_token
Get short lived token
motherduckmcp_list_flight_runs
List flight runs
motherduckmcp_update_dive
Update dive
motherduckmcp_list_flight_versions
List flight versions
motherduckmcp_create_guide
Create guide
motherduckmcp_update_guide
Update guide
motherduckmcp_create_flight
Create flight
motherduckmcp_update_flight
Update flight
motherduckmcp_query
Query
motherduckmcp_update_guide_metadata
Update guide metadata
motherduckmcp_query_rw
Query rw
motherduckmcp_read_dive
Read dive
motherduckmcp_save_dive
Save dive
Build your Agent
Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.
Python · LlamaIndex
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="motherduckmcp")

mcp = MultiServerMCPClient({
"motherduckmcp": {
"url": "https://mcp.scalekit.com/motherduckmcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()
import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "motherduckmcp" });

const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/motherduckmcp
// Pass: Authorization: Bearer + token
import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "motherduckmcp" });

const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/motherduckmcp
// Pass: Authorization: Bearer + token
from google.adk.agents import LlmAgent
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="motherduckmcp")
# Connect to MCP at https://mcp.scalekit.com/motherduckmcp
# Pass: Authorization: Bearer + token
Try these prompts
Copy any prompt into your agent. Each maps directly to a MotherDuck tool. Click to copy, paste into your agent, done.
Get started
Copy the prompt
Copied
Render a MotherDuck Dive as a live, interactive MCP app inside the host client?
Copy the prompt
Copied
Update a Flight’s source code, dependencies, config, authentication tokens, secrets, name, or schedule?
Advanced
Copy the prompt
Copied
Make a Dive’s underlying data accessible to your organization by creating org-scoped shares for owned databases referenc?
Copy the prompt
Copied
Fuzzy search across the MotherDuck catalog (databases, schemas, tables, columns, shares) using Jaro-Winkler similarity s?
SEE HOW AUTH WORKS
Your users connect once. Their MotherDuck credentials stay vaulted, every call is scope-checked, and every action is logged.
1
Authorize
Your user connects
MotherDuck MCP
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
MotherDuck MCP
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
MotherDuck MCP
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
MotherDuck MCP
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
See the same per-user auth pattern across other connectors.
GTM and RevOps Teams
Revenue forecast commentary
Pulls open pipeline from Salesforce and HubSpot, calculates coverage against quota, flags at-risk stages, posts commentary to Slack, and logs every snapshot to Google Sheets.
GTM and RevOps Teams
Deal intelligence agent
Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.
Engineering Teams
Engineering standup agent
Pulls commits from GitHub and GitLab, tracks issue movement in Jira, and posts a per-engineer standup brief to Slack. Each engineer's activity is read on their own delegated OAuth.
GTM and RevOps Teams
Competitive intelligence briefing agent
Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.
Test other agents
See the same per-user auth pattern across other connectors.
GTM
Revenue forecast agent
Score pipeline coverage against quota across Salesforce and HubSpot, post forecast commentary to Slack, log snapshots to Sheets.
SALES
Deal intelligence agent
Score Gong call risk with an LLM, cross-reference the Attio record, and DM each owner their at-risk deals in Slack.
ENGINEERING
Engineering standup agent
Pull commits from GitHub and GitLab, track Jira issue movement, and post a per-engineer standup brief to Slack.
GTM
Competitive intelligence briefing agent
Scan Gong calls for competitor mentions, match each one to its Notion battlecard, and DM every affected rep a single Slack digest.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential.
// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
One connector today. Ten tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions

Does the agent access MotherDuck as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the MotherDuck OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in MotherDuck?
Yes. Pass a tool name filter to listScopedTools so the DevOps agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches MotherDuck.

What happens when a user revokes MotherDuck access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Which databases can DuckDB queries reach?
Only databases in the authorizing user's MotherDuck account. Queries, schema exploration, and visualizations run per user, so shared analytics never leak across tenant boundaries.

Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""motherduckmcp"": {
""url"": ""https://mcp.scalekit.com/motherduckmcp"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.motherduckmcp]
url = ""https://mcp.scalekit.com/motherduckmcp""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""motherduckmcp"": {
""url"": ""https://mcp.scalekit.com/motherduckmcp"",
""type"": ""http""
}
}
}