Whalesync — Claude Code MCP server: what it does, how to install
Remote endpoint enabling coding assistants to configure bidirectional data pipelines across tools like Notion, Airtable, and Postgres.
claude mcp add --transport http whalesync https://api.whalesync.com/mcpWhat Whalesync does
This is a hosted service running at https://api.whalesync.com/mcp via Streamable HTTP, so no local repository build is required. It equips your coding agent with 24 dedicated tools to inspect connectors, map schema fields, and track sync health directly in chat.
Potentially destructive operations remain strictly guarded by humans. Starting an active pipeline, authorizing external apps, or approving deletions cannot happen autonomously; the assistant hands over a direct web URL to confirm each step.
Authentication relies on browser-driven OAuth 2.1 with PKCE instead of static API tokens. Running any sync command without an existing Whalesync workspace will halt until you sign in during the browser prompt.
What it helps with
- troubleshoot why a specific database record failed to sync
- map tables and attributes between two connected applications
- inspect unresolved pipeline issues and trigger automated retries
- pause or delete active data synchronizations
Example prompts for the agent
- List all tables and fields available in my Postgres connector
- Check why the latest sync operation failed and retry the issue
- Validate the field mappings configured for this Airtable base
How to install Whalesync
Platform CLI: remote server
claude mcp add --transport http whalesync https://api.whalesync.com/mcpPlatform CLI: remote server
codex mcp add whalesync --url https://api.whalesync.com/mcpConfig file
{
"mcpServers": {
"whalesync": {
"url": "https://api.whalesync.com/mcp"
}
}
}Config file
{
"servers": {
"whalesync": {
"type": "http",
"url": "https://api.whalesync.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http whalesync https://api.whalesync.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Whalesync
How do I install Whalesync in Claude Code?
Run claude mcp add --transport http whalesync https://api.whalesync.com/mcp in your terminal. Your client will launch a browser tab to authenticate via OAuth on first execution.
What does the Whalesync MCP server do?
It exposes tools for structuring two-way synchronization workflows, verifying field alignments, and diagnosing transfer errors across connected data platforms.
Can the agent delete data or start syncs automatically?
Critical steps remain human-gated. The agent outputs a dashboard URL whenever you need to connect new apps, activate data flows, or confirm record deletions.
