airbyte-ops-mcp

MCP and API interfaces that let the agents do the admin work.

How to Contribute

  • CONTRIBUTING.md — contributor setup, local testing, and development workflows.
  • AGENTS.md — agent-specific operating guidance.

Documentation

Ops Repo Subprojects

Subproject Root dir Description Release notes
airbyte-internal-ops . MCP server and airbyte-ops CLI for Airbyte admin operations. v0 releases
airbyte-cloud-cli airbyte-cloud-cli/ Standalone CLI for Airbyte Cloud operations. v0 releases
Sentry infrastructure infra/sentry/ Pulumi project for connector error monitoring configuration. N/A
Agent message bus infrastructure infra/agent-message-bus/ Pulumi and Cloud Run app for internal agent messaging. N/A

GitHub's Releases UI does not group releases by package automatically. Use a tag filter with the exact tag namespace and at least major-version precision, such as tag:v0 or tag:airbyte-cloud-cli/v0, or use the links above.

Installing Ops MCP in your Client

This config example will help you add the MCP server to your client:

{
  "mcpServers": {
    "airbyte-ops-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--project=/Users/aj.steers/repos/airbyte-ops-mcp/",
        "airbyte-ops-mcp"
      ],
      "env": {
        "AIRBYTE_MCP_ENV_FILE": "/Users/{user-id}/.mcp/airbyte_mcp.env"
      }
    },
    "airbyte-coral-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--python=3.11",
        "--from=airbyte@latest",
        "airbyte-mcp"
      ],
      "env": {
        "AIRBYTE_MCP_ENV_FILE": "/Users/{user-id}/.mcp/airbyte_mcp.env"
      }
    }
  }
}

Connecting to the hosted MCP servers

Use interactive OAuth by default. The client opens a browser to complete the login flow; do not add a headers block:

{
  "mcpServers": {
    "airbyte-ops-mcp": {
      "type": "http",
      "url": "https://mcp.internal.airbyte.ai/ops-mcp"
    },
    "airbyte-cloud-mcp": {
      "type": "http",
      "url": "https://mcp.internal.airbyte.ai/cloud-mcp"
    }
  }
}

MCP client configuration syntax is client-specific. The block above uses the common type: "http" and url spelling. For Goose, use type: "streamable_http" and uri instead:

{
  "mcpServers": {
    "airbyte-ops-mcp": {
      "type": "streamable_http",
      "uri": "https://mcp.internal.airbyte.ai/ops-mcp"
    },
    "airbyte-cloud-mcp": {
      "type": "streamable_http",
      "uri": "https://mcp.internal.airbyte.ai/cloud-mcp"
    }
  }
}

Use the hosted endpoint path exactly as shown; do not append /mcp.

For a headless client, use the two credential headers instead:

{
  "mcpServers": {
    "airbyte-ops-mcp": {
      "type": "http",
      "url": "https://mcp.internal.airbyte.ai/ops-mcp",
      "headers": {
        "Client-Id": "${AIRBYTE_CLOUD_CLIENT_ID}",
        "Client-Secret": "${AIRBYTE_CLOUD_CLIENT_SECRET}"
      }
    },
    "airbyte-cloud-mcp": {
      "type": "http",
      "url": "https://mcp.internal.airbyte.ai/cloud-mcp",
      "headers": {
        "Client-Id": "${AIRBYTE_CLOUD_CLIENT_ID}",
        "Client-Secret": "${AIRBYTE_CLOUD_CLIENT_SECRET}"
      }
    }
  }
}

Whether ${ENV} references are expanded inside a headers block depends on the client; if not, provide the credential values through that client's supported secret configuration.

The credential-header form is enabled on airbyte-ops-mcp. It is not yet enabled on airbyte-cloud-mcp; sending those headers there currently triggers the client's OAuth fallback, which opens a browser consent page at https://mcp.internal.airbyte.ai/cloud-mcp/consent and can leave the client waiting instead of showing the underlying 401. The PyAirbyte server must first receive the corresponding support. See docs/authentication.md for the full authentication model and security guidance.

Your .env file should include the following values:

# Creds for Airbyte Cloud OAuth
AIRBYTE_CLOUD_CLIENT_ID="..."
AIRBYTE_CLOUD_CLIENT_SECRET="..."

# Required for elevated admin operations
AIRBYTE_INTERNAL_ADMIN_FLAG=airbyte.io
AIRBYTE_INTERNAL_ADMIN_USER={my-id}@airbyte.io

# Workspace ID for Testing
AIRBYTE_CLOUD_TEST_WORKSPACE_ID="..."

Onboarding

If this is your first time working with Airbyte's connector tooling, see ONBOARDING.md for instructions on setting up required credentials like GCP_GSM_CREDENTIALS.

Connector Registry

For an overview of the connector registry architecture, operations, and CLI commands, see docs/connector-registry.md.

For release-block marker operations that prevent republishing known-bad connector code after a yank, see docs/release-blocks.md.

For details on known, intentional differences between the new Registry 2.0 generation pipeline and the legacy pipeline, see Connector Registry 2.0 Migration Changes in CONTRIBUTING.md.

Getting Started

Once configured, use the test_my_tools prompt by typing "/test" into your agent and selecting the auto-complete option for the test_my_tools prompt.

This prompt will step through all the tools, demoing their capabilities.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.102.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for airbyte-engineering from gravatar.com airbyte-engineering

Credits

Author: Aaron Steers

License

MIT License

Requires

Python <3.13, >=3.11

Tags

admin airbyte api mcp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airbyte_internal_ops-0.100.0.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

airbyte_internal_ops-0.100.0-py3-none-any.whl (726.9 kB view details)

Uploaded Python 3

File details

Details for the file airbyte_internal_ops-0.100.0.tar.gz.

File metadata

  • Download URL: airbyte_internal_ops-0.100.0.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for airbyte_internal_ops-0.100.0.tar.gz
Algorithm Hash digest
SHA256 220f16822a35a1ddf553e68618f593b1f89cd693000b6c8d5931e36a9e60d4ce
MD5 621af05b391fea918abced578459a017
BLAKE2b-256 7efdc8cf3a85ca28bfd6470ffb1028c7829c5c2a104fc2c5b5d6b01308be742d

See more details on using hashes here.

Provenance

The following attestation bundles were made for airbyte_internal_ops-0.100.0.tar.gz:

Publisher: publish.yml on airbytehq/airbyte-ops-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file airbyte_internal_ops-0.100.0-py3-none-any.whl.

File metadata

File hashes

Hashes for airbyte_internal_ops-0.100.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1b05a611e7445e599e6f872fedecab5a8e7e317f2a73c41c72221807bb60edf5
MD5 7390c761ed933ab1fac9449399f7ebc9
BLAKE2b-256 3884fde3aed43dc962468fb930608e1f2b0b13d9afa917c1d4c3984004b1da8b

See more details on using hashes here.

Provenance

The following attestation bundles were made for airbyte_internal_ops-0.100.0-py3-none-any.whl:

Publisher: publish.yml on airbytehq/airbyte-ops-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.102.0

0.101.1

0.101.0

This release

0.100.0

0.99.0

0.98.2

0.98.1

0.98.0

0.94.4

0.94.3

0.94.2

0.94.1

0.94.0

0.93.0

0.92.0

0.91.0

0.90.0

0.89.1

0.89.0

0.88.1

0.88.0

0.87.0

0.86.1

0.86.0

0.85.0

0.84.0

0.83.0

0.82.1

0.82.0

0.81.0

0.80.0

0.79.0

0.78.0

0.77.0

0.76.0

0.75.1

0.75.0

0.74.0

0.73.5

0.73.4

0.73.3

0.73.2

0.73.1

0.73.0

0.72.0

0.71.0

0.70.1

0.70.0

0.69.0

0.68.3

0.68.2

0.68.1

0.68.0

0.67.0

0.66.0

0.65.0

0.64.6

0.64.5

0.64.4

0.64.3

0.64.2

0.64.1

0.64.0

0.63.0

0.62.4

0.62.3

0.62.2

0.62.1

0.62.0

0.61.2

0.61.1

0.61.0

0.60.1

0.60.0

0.59.0

0.58.0

0.57.0

0.56.0

0.55.0

0.54.0

0.53.0

0.52.0

0.51.1

0.51.0

0.50.0

0.49.2

0.49.1

0.49.0

0.48.1

0.48.0

0.47.0

0.46.0

0.45.0

0.44.2

0.44.1

0.44.0

0.43.1

0.43.0

0.42.0

0.41.1

0.41.0

0.40.1

0.40.0

0.39.1

0.39.0

0.38.0

0.37.0

0.36.0

0.35.1

0.35.0

0.34.0

0.33.3

0.33.2

0.33.1

0.33.0

0.32.1

0.32.0

0.31.3

0.31.2

0.31.1

0.31.0

0.30.2

0.30.1

0.30.0

0.29.1

0.29.0

0.28.2

0.28.1

0.28.0

0.27.3

0.27.2

0.27.1

0.27.0

0.26.1

0.26.0

0.25.0

0.24.1

0.24.0

0.23.1

0.23.0

0.22.0

0.21.0

0.20.0

0.19.0

0.18.0

0.17.0

0.16.0

0.15.0

0.14.0

0.13.2

0.13.1

0.13.0

0.12.0

0.11.0

0.10.3

0.10.2

0.10.1

0.10.0

0.9.1

0.9.0

0.8.0

0.7.1

0.7.0

0.6.1

0.6.0

0.5.2

0.5.1

0.5.0

0.4.2

0.4.1

0.4.0

0.3.1

0.3.0

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2.post2.dev20080805740 pre-release

0.1.2

0.1.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page