# Whalesync

Remote endpoint enabling coding assistants to configure bidirectional data pipelines across tools like Notion, Airtable, and Postgres.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: whalesync
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/whalesync/whalesync-mcp
- Updated: 2026-09-11
- HTML: https://affpapa.org/en/nevibecode/mcp/whalesync

## What it 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.

## Requirements
- Remote server: `https://api.whalesync.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http whalesync https://api.whalesync.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add whalesync --url https://api.whalesync.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whalesync": {
            "url": "https://api.whalesync.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whalesync": {
            "type": "http",
            "url": "https://api.whalesync.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http whalesync https://api.whalesync.com/mcp
```

## When to use it
- 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
- 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

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md