Skip to content

docs(mcp): Add Airbyte MCP overview to README #1434

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Ian Alton (ian-at-airbyte) merged 2 commits into from
Oct 30, 2026
Merged

docs(mcp): Add Airbyte MCP overview to README #1434

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
636a871
docs(mcp): Add Airbyte MCP overview to README
devin-ai-integration[bot] Oct 30, 2026
ce08b87
docs(mcp): Clarify permissions and direct reads
devin-ai-integration[bot] Oct 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,24 @@ Watch this [Getting Started Loom video](https://www.loom.com/share/3de81ca3ce914
* [GitHub](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Github_Incremental_Demo.ipynb)
* [Postgres (cache)](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Postgres_Custom_Cache_Demo.ipynb)

## Airbyte MCP

The [Airbyte MCP](https://docs.airbyte.com/platform/airbyte-mcp) is a [Model Context Protocol](https://modelcontextprotocol.io/) server that connects AI agents to your Airbyte organization. Your agent works with the same permissions you have in Airbyte. Use it with clients such as Claude, ChatGPT, and VS Code Copilot.

With the Airbyte MCP, your agent can:

* Build and manage pipelines: deploy sources and destinations, create connections, select streams, and start syncs.
* Troubleshoot pipelines: check sync status, read job logs, and inspect connector configurations.
* Read data directly: get live records from supported sources and query supported destinations without waiting for a sync.
* Learn connector capabilities through connector skills, which describe supported entities, actions, and parameters.
* Find answers in Airbyte's documentation and other Airbyte knowledge sources.

Direct reads are read-only and only work with supported connectors after an organization admin enables the [context layer](https://docs.airbyte.com/platform/context-layer). They do not work with connectors whose secrets are stored in an external secrets manager.

The hosted server works with all editions of Airbyte Cloud and Airbyte Flex. You can [run it locally with self-managed Airbyte Core](https://docs.airbyte.com/platform/airbyte-mcp/self-managed), but local deployments have known issues.

To connect, use `https://mcp.airbyte.com/mcp` and sign in with your Airbyte Cloud account through OAuth. See the [installation instructions](https://docs.airbyte.com/platform/airbyte-mcp/install) and [complete tool list](https://docs.airbyte.com/platform/airbyte-mcp/tools).

## Connector Installation

### Declarative Source Installation
Expand Down
Loading