Airbyte knowledge MCP server
If you use Airbyte Cloud, use the Airbyte MCP instead. It includes Airbyte knowledge search, plus tools to build, monitor, and troubleshoot your data pipelines. You only need the knowledge MCP server if you use Airbyte Core.
The Airbyte knowledge MCP server connects AI agents to comprehensive sources of information about Airbyte. It provides semantic search over Airbyte's documentation, website, OpenAPI specs, YouTube content, and GitHub issues, discussions, and pull requests.
Use it to provide Airbyte knowledge to agents. It doesn't let agents work with your data. To build and manage data pipelines, use the Airbyte MCP. To work with data through Airbyte Agents, use the Agent MCP.
When to use it
The Airbyte knowledge MCP is helpful when your AI agent is:
- Building a custom connector
- Working with PyAirbyte, Airbyte's Terraform provider, or REST API to configure sources, destinations, and connections
- Troubleshooting sync errors or connection issues
- Learning about Airbyte's architecture or deployment options
Any time an agent performs a task that requires Airbyte product or developer context, the MCP server can provide relevant knowledge.
Connecting to the MCP server
The server URL is https://airbyte.mcp.kapa.ai.
Cursor and VS Code
If you're using Cursor or VS Code, you can connect with one click through the Ask AI button in the Airbyte documentation. Click the button, then select the MCP install option from the dropdown menu.
Claude
If you're using Claude Desktop or Claude Code, run the following command in your system terminal (e.g., Terminal on macOS, Command Prompt/PowerShell on Windows, or your preferred shell on Linux):
claude mcp add --transport http airbyte-docs https://airbyte.mcp.kapa.ai
Other AI tools
The Airbyte knowledge MCP works with any MCP-compatible tool, including Windsurf and ChatGPT Desktop. Refer to your tool's documentation for instructions on adding MCP servers, and use the server URL https://airbyte.mcp.kapa.ai.
Authentication
When connecting for the first time, you'll be prompted to sign in with any Google account. This authentication is used only to enforce rate limits and prevent abuse of the server. Airbyte does not access your email, name, or other personal data.
Manually triggering authentication
For Claude: If you need to authenticate (or re-authenticate) with the Airbyte Knowledge MCP server, you can manually trigger the authentication flow from within Claude Code CLI.
- In your Claude Code session, type
/mcp list - Select airbyte-docs from the list of available MCP servers
- This will initiate the Google authentication flow in your browser
- Once authenticated, you'll see a confirmation message: "Authentication successful. Connected to airbyte-docs."
This is useful if you dismissed the initial authentication prompt, your authentication has expired, or you want to verify your connection status.
Rate limits
Each authenticated user is limited to 40 requests per hour and 200 requests per day.