Introduction
AI agents are moving from isolated demos into real operational workflows. To be effective, they need access to data spread across many tools—Slack, Salesforce, Linear, Gong, and more. But bridging these systems is messy: each API comes with its own authentication, pagination, schema, and entity-matching quirks. Most existing MCP servers are thin wrappers over APIs, so agents inherit the same weak primitives and still produce wrong answers, especially when reasoning across multiple sources.
Airbyte Agents solve this by acting as a unified context layer. At its core is the Context Store—a data index optimized for agentic search, populated by Airbyte's battle-tested replication connectors (built over six years). Agents can discover relevant information in a structured way, then read or write directly to upstream systems only when needed. According to CEO Michel, a typical agent trace that took 47 API calls to answer “Which customers are at risk of leaving?” was reduced dramatically in both speed and accuracy. This guide shows you how to set up and use Airbyte Agents in your own environment.
What You Need
- An Airbyte account – sign up at airbyte.com (free tier available).
- Access to your data sources – e.g., Slack, Salesforce, Linear, Gong, or any of the 350+ connectors.
- An AI agent framework – currently supported via MCP (Model Context Protocol) or Airbyte’s own SDK.
- Basic familiarity with API concepts – you should understand authentication tokens, pagination, and schema fields.
- A benchmark tool (optional but recommended) – to measure token consumption and agent performance.
Step-by-Step Guide
Step 1: Set Up Airbyte and Configure Your Connectors
Log into your Airbyte instance (cloud or self-hosted). Navigate to the Sources section and add each data source you want your agents to access—for example, a Salesforce account, a Slack workspace, and a Linear project. Airbyte provides pre-built connectors that handle authentication, pagination, and schema inference automatically. For each source, enter required credentials (API keys, OAuth tokens) and test the connection. Once verified, define a replication frequency (e.g., every 6 hours) to keep the Context Store current.
Step 2: Create and Populate the Context Store
The Context Store is Airbyte’s data index, optimized for agentic search. Go to the Destinations section and select “Context Store” as your target. Map the streams from your sources to this destination. Airbyte will automatically flatten nested objects and create a unified schema. For example, an “account” in Salesforce and a “contact” in Gong become entries in the same index with aligned fields. This step eliminates the need for agents to manually join records across systems. The first sync will populate the store; subsequent syncs update only changed data (incremental).
Step 3: Connect Your Agent to the Context Store via MCP or SDK
Airbyte Agents expose the Context Store through two interfaces: an MCP server and a native SDK. If you’re using an existing agent framework (like LangChain, CrewAI, or a custom solution), point it to the MCP endpoint provided in your Airbyte dashboard. The MCP server implements standard discovery and retrieval tools. Alternatively, install the Airbyte SDK (Python/JS) for tighter integration—this allows your agent to call airbyte.context.query() directly. In either case, your agent now has a unified view of all data without needing multiple API connections.
Step 4: Query and Retrieve Context Efficiently
Instead of making 47 API calls to answer a single question (like “Which customers are at risk of leaving this quarter?”), your agent can now issue one or two queries to the Context Store. Use natural language or structured filters—the store supports semantic search over fields, object IDs, and relationships. For example, a query like “Show me all enterprise deals closing this month with open support tickets” is translated into a fetch from the index, returning pre-joined results. This reduces token consumption dramatically because the agent doesn’t have to assemble context at runtime. As benchmarked by Airbyte’s CEO, calling the Airbyte MCP used significantly fewer tokens than invoking individual vendor MCPs for Gong and other systems.
Step 5: Enable Write-Back to Upstream Systems When Needed
While the Context Store is primarily for reading, your agent may need to update records – e.g., closing a ticket in Zendesk or creating a GitHub issue. Airbyte Agents allow write back to the source system through the same unified layer. Use the Action tools provided in the MCP or SDK: these perform authenticated API calls behind the scenes, handling pagination and error retries automatically. This ensures that even write operations benefit from Airbyte’s connector expertise, without your agent having to manage raw API calls.
Step 6: Test and Optimize with Benchmarks
Once your agent is connected, run it against real queries and measure token consumption. A failing or slow agent will churn tokens while getting nowhere; a successful one will answer concisely. Airbyte’s internal benchmark used token usage as a proxy for agent efficiency. Compare results when using the Airbyte MCP vs. calling source APIs directly. Look for reductions in both step count and total tokens. Adjust Context Store sync frequency and index fields (e.g., by enabling additional streams) to improve recall. Iterate until your agent consistently returns accurate answers within acceptable token budgets.
Tips for Success
- Start with simple questions – e.g., “Find every support ticket that doesn’t have a GitHub issue opened.” This validates that your connectors and Context Store are aligned.
- Monitor token consumption closely – as highlighted in the original benchmark, token usage is a good proxy for agent efficiency. Set alerts for spikes.
- Use schema alignment – Airbyte’s automatic flattening is powerful, but you can manually define transformations to better match your agent’s expected structure.
- Leverage incremental syncs – do not re-sync full datasets daily; incremental updates keep latency low and costs manageable.
- Combine with your own caching – if your agent asks the same question repeatedly, cache results to further reduce token usage.
- Keep your connectors updated – Airbyte regularly ships connector improvements that improve speed and reliability.
- Test edge cases – like empty result sets or missing fields. Your agent should handle those gracefully without falling into a long loop of API calls.