# discovering-connectors

Lists the Airbyte connectors available to an agent, with their entities, actions, schemas and auth requirements.

Skill by Airbyte. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx skills add airbytehq/airbyte-agent-sdk --skill discovering-connectors
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add airbytehq/airbyte-agent-sdk --skill discovering-connectors -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 33. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/airbytehq/airbyte-agent-sdk/discovering-connectors)

## Source

[Open the source](https://github.com/airbytehq/airbyte-agent-sdk/tree/HEAD/.codex/skills/discovering-connectors). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: discovering-connectors
description: Discovers available Airbyte connectors, explores their entities/actions/schemas, and checks auth requirements. Use when asking what connectors exist, what a connector can do, or what fields/entities are available.
---

# Discovering Connectors

## Programmatic Discovery

```python
from airbyte_agent_sdk import list_connectors

available = list_connectors()
# Returns sorted list of connector slugs: ["airtable", "asana", "github", ...]
```

## Exploring a Connector's Capabilities

Each connector has documentation at:
`https://github.com/airbytehq/airbyte-agent-sdk/tree/main/connectors/{name}`

| File | What it tells you |
|------|-------------------|
| `README.md` | Entities/actions table, install instructions, example questions |
| `AUTH.md` | Credential requirements (OAuth, API key, etc.), hosted setup |
| `REFERENCE.md` | Full entity/action parameters and schemas |

Read the connector's README first to understand what it can do.

## Runtime Introspection

When a typed connector package is installed, use runtime methods for schema details:

```python
from airbyte_agent_sdk import AirbyteAuthConfig
from airbyte_agent_sdk.connectors.stripe import StripeConnector

connector = StripeConnector(
    auth_config=AirbyteAuthConfig(
        airbyte_client_id=os.getenv("AIRBYTE_CLIENT_ID"),
        airbyte_client_secret=os.getenv("AIRBYTE_CLIENT_SECRET"),
        workspace_name=os.getenv("AIRBYTE_WORKSPACE_NAME", "default"),
    )
)

# List all entities and their available actions
entities = connector.list_entities()
for entity in entities:
    print(f"{entity['entity_name']}: {entity['available_actions']}")

# Get JSON schema for a specific entity
schema = connector.entity_schema("customers")
```

**Note**: `list_entities()` and `entity_schema()` require a typed connector (available after `uv pip install airbyte-agent-sdk`). They are not available on the generic `HostedExecutor`.

## Auth Requirements

Read the connector's `AUTH.md` to understand what credentials are needed. For hosted mode (the default), API credentials are stored in Airbyte Cloud — you provide Airbyte client credentials instead.

## References

- [SDK API reference](../airbyte-sdk-reference/sdk-api.md)
- [Connector discovery details](../airbyte-sdk-reference/connector-discovery.md)
````

- Previous: [building-multi-connector-agent](https://syn4pse.dev/terminal/airbyte-building-multi-connector-agent.md)
- Next: [airbyte-agent-sdk](https://syn4pse.dev/terminal/airbyte-agent-sdk.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
