From 636a871c608657eacd57f877ee36c4f6763ad51d Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Fri, 30 Oct 2026 19:22:26 +0000
Subject: [PATCH 1/2] docs(mcp): Add Airbyte MCP overview to README

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index dc1ad6286..0dbf47e69 100644
--- a/README.md
+++ b/README.md
@@ -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. 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 live data 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

From ce08b873d83a14557cd40019d8ade152e35000b1 Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Fri, 30 Oct 2026 19:24:43 +0000
Subject: [PATCH 2/2] docs(mcp): Clarify permissions and direct reads

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0dbf47e69..8c5c44fcc 100644
--- a/README.md
+++ b/README.md
@@ -26,13 +26,13 @@ Watch this [Getting Started Loom video](https://www.loom.com/share/3de81ca3ce914
 
 ## 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. Use it with clients such as Claude, ChatGPT, and VS Code Copilot.
+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 live data from supported sources and query supported destinations without waiting for a sync.
+* 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.