Skip to main content

Agent Engine MCP server

The Airbyte Agent Engine MCP server connects your AI agent to your data through the Model Context Protocol (MCP). It gives your agent authenticated access to the platforms you use every day, like your CRM, support desk, analytics tools, and more, so your agent can read and write data on your behalf. See Connectors for a list of available connectors.

Airbyte hosts and manages this remote MCP server, so there's nothing to install.

Requirements​

Before you begin, make sure you have the following:

  • An Agent Engine account. Sign up at app.airbyte.ai if you don't have one.

  • An AI agent that supports MCP. For example, Claude Desktop, Claude Code, Cursor, or Codex.

  • Credentials for the connectors you want to use. Each service requires its own authentication. For example, you need a Linear API key to connect Linear, or Salesforce OAuth credentials to connect Salesforce.

Add the MCP server to your agent​

Select your client below for setup instructions. Each client requires you to authenticate with your Airbyte account before you can use the MCP server.

Add the MCP server to your Claude Code command line tool.

  1. Run the following command in your terminal:

    claude mcp add --transport http airbyte-agent https://mcp.airbyte.ai/mcp

  2. Run Claude Code with claude.

  3. Type /mcp.

  4. Select the airbyte-agent MCP you added in step 1.

  5. Select Authenticate. Your web browser opens.

  6. If you're not logged into the Agent Engine, log in now.

  7. Grant access to the Agent Engine MCP.

  8. Return to Claude Code and begin using the MCP server.

Example usage​

After you connect the MCP server, your agent can discover and call its tools automatically based on your prompts. The following examples show common actions.

Add a connector​

To connect a new data source, prompt your agent with the service you want to connect. The MCP can use any Airbyte agent connector. The agent handles the setup, including starting a browser-based credential flow where you enter your credentials securely.

Connect my Linear account

The agent:

  1. Starts a credential flow and gives you a URL to visit.
  2. You visit the URL and enter your credentials in the browser.
  3. The agent confirms the connector was created and is ready to query.
note

Credentials are always entered in the browser, never in the chat.

Remove a connector​

To remove a connector you no longer need:

Delete my Linear connector

Query data​

After you connect a data source, prompt your agent. The agent discovers the available entities, understands their schemas, and executes the right queries.

Show me the 10 most recent Gong calls
Find all open deals in Salesforce worth more than $50,000
List HubSpot contacts who were created this week
How many Zendesk tickets are in "open" status?

The agent uses field selection to return only the data you need, which reduces token usage and improves response quality.

Troubleshooting​

Authentication fails​

  • Make sure you have an active account at app.airbyte.ai.
  • Try logging out of your agent's MCP integration and reconnecting to trigger a fresh OAuth flow.
  • If you joined a new Airbyte organization, authenticate again to refresh your access.

Agent can't find the MCP server​

  • Restart your agent after adding the MCP server configuration.
  • Verify the server URL is exactly https://mcp.airbyte.ai/mcp in your configuration.
  • Check that your client supports Streamable HTTP or OAuth-based MCP servers.

Connector credential flow doesn't complete​

  • Make sure you visited the credential URL the agent provided and completed the form in the browser.
  • If the flow timed out, ask the agent to start a new credential flow.

Queries return unexpected results​

  • Ask the agent to describe the available entities before querying, so it picks the right one.
  • For time-based queries, the agent resolves relative dates like "this week" or "last month" automatically.
Was this page helpful?