airbyte-agent-chargebee 0.1.0__tar.gz

airbyte_agent_chargebee-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml
+
+# Claude Code development symlink
+# Contributors: Create this symlink locally for skill testing
+# mkdir -p .claude/skills && ln -s ../../skills/airbyte-agent-connectors .claude/skills/airbyte-agent-connectors
+.claude/skills/airbyte-agent-connectors

airbyte_agent_chargebee-0.1.0/AUTH.md

@@ -0,0 +1,123 @@
+# Chargebee authentication
+
+This page documents the authentication and configuration options for the Chargebee agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Chargebee API key (used as the HTTP Basic username) |
+
+Example request:
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector
+from airbyte_agent_chargebee.models import ChargebeeAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=ChargebeeAuthConfig(
+        api_key="<Your Chargebee API key (used as the HTTP Basic username)>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Bring your own OAuth flow
+This authentication method isn't available for this connector.
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Chargebee API key (used as the HTTP Basic username) |
+
+`replication_config` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `start_date` | `str (date-time)` | Yes | UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ. Data before this date is excluded. |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/api/v1/integrations/connectors" \
+  -H "Authorization: Bearer <YOUR_BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "customer_name": "<CUSTOMER_NAME>",
+    "connector_type": "Chargebee",
+    "name": "My Chargebee Connector",
+    "credentials": {
+      "api_key": "<Your Chargebee API key (used as the HTTP Basic username)>"
+    },
+    "replication_config": {
+      "start_date": "<UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ. Data before this date is excluded.>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+If your Airbyte client can access multiple organizations, include `organization_id` in `AirbyteAuthConfig` and `X-Organization-Id` in raw API calls.
+
+**Python SDK**
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector, AirbyteAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ChargebeeConnector.tool_utils
+async def chargebee_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/integrations/connectors/<connector_id>/execute' \
+  -H 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
+  -H 'X-Organization-Id: <YOUR_ORGANIZATION_ID>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+
+## Configuration
+
+The Chargebee connector requires the following configuration variables. These variables are used to construct the base API URL. Pass them via the `config` parameter when initializing the connector.
+
+| Variable | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `site` | `string` | Yes | your-site | Your Chargebee site name (subdomain) |

airbyte_agent_chargebee-0.1.0/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Chargebee changelog
+
+## [0.1.0] - 2026-03-04
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: b3431b73
+- SDK version: 0.1.0

airbyte_agent_chargebee-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-chargebee
+Version: 0.1.0
+Summary: Airbyte Chargebee Connector for AI platforms
+Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,api,chargebee,connector,data-integration,llm,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Chargebee
+
+The Chargebee agent connector is a Python package that equips AI agents to interact with Chargebee through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the Chargebee billing and subscription management API. Supports reading subscriptions, customers, invoices, credit notes, coupons, transactions, events, orders, items, item prices, and payment sources. Chargebee is a recurring billing platform that helps SaaS and subscription businesses manage the full subscription lifecycle.
+
+
+## Example questions
+
+The Chargebee connector is optimized to handle prompts like these.
+
+- List all active subscriptions
+- Show me details for a specific customer
+- List recent invoices
+- Show me details for a specific subscription
+- List all coupons
+- List recent transactions
+- List recent events
+- Show me customers with the highest monthly recurring revenue
+- Which subscriptions are set to cancel in the next 30 days?
+- List all overdue invoices and their amounts
+- Analyze subscription churn trends over the past quarter
+- What are the most popular items by number of subscriptions?
+- Show me total revenue breakdown by currency
+- Identify customers with expiring payment sources
+- Compare subscription plan distribution across item prices
+- List all credit notes issued in the past month
+- What is the average subscription lifetime for each plan?
+
+## Unsupported questions
+
+The Chargebee connector isn't currently able to handle prompts like these.
+
+- Create a new subscription in Chargebee
+- Update a customer's billing address
+- Cancel a subscription
+- Apply a coupon to a subscription
+- Issue a refund for an invoice
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-chargebee
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector
+from airbyte_agent_chargebee.models import ChargebeeAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=ChargebeeAuthConfig(
+        api_key="<Your Chargebee API key (used as the HTTP Basic username)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ChargebeeConnector.tool_utils
+async def chargebee_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector, AirbyteAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ChargebeeConnector.tool_utils
+async def chargebee_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customer | [List](./REFERENCE.md#customer-list), [Get](./REFERENCE.md#customer-get), [Search](./REFERENCE.md#customer-search) |
+| Subscription | [List](./REFERENCE.md#subscription-list), [Get](./REFERENCE.md#subscription-get), [Search](./REFERENCE.md#subscription-search) |
+| Invoice | [List](./REFERENCE.md#invoice-list), [Get](./REFERENCE.md#invoice-get), [Search](./REFERENCE.md#invoice-search) |
+| Credit Note | [List](./REFERENCE.md#credit-note-list), [Get](./REFERENCE.md#credit-note-get), [Search](./REFERENCE.md#credit-note-search) |
+| Coupon | [List](./REFERENCE.md#coupon-list), [Get](./REFERENCE.md#coupon-get), [Search](./REFERENCE.md#coupon-search) |
+| Transaction | [List](./REFERENCE.md#transaction-list), [Get](./REFERENCE.md#transaction-get), [Search](./REFERENCE.md#transaction-search) |
+| Event | [List](./REFERENCE.md#event-list), [Get](./REFERENCE.md#event-get), [Search](./REFERENCE.md#event-search) |
+| Order | [List](./REFERENCE.md#order-list), [Get](./REFERENCE.md#order-get), [Search](./REFERENCE.md#order-search) |
+| Item | [List](./REFERENCE.md#item-list), [Get](./REFERENCE.md#item-get), [Search](./REFERENCE.md#item-search) |
+| Item Price | [List](./REFERENCE.md#item-price-list), [Get](./REFERENCE.md#item-price-get), [Search](./REFERENCE.md#item-price-search) |
+| Payment Source | [List](./REFERENCE.md#payment-source-list), [Get](./REFERENCE.md#payment-source-get), [Search](./REFERENCE.md#payment-source-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Chargebee API docs
+
+See the official [Chargebee API reference](https://apidocs.chargebee.com/docs/api).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** b3431b73e8fc55d38ab8e68a9f96fef6278c7440
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/chargebee/CHANGELOG.md)

airbyte_agent_chargebee-0.1.0/README.md

@@ -0,0 +1,129 @@
+# Chargebee
+
+The Chargebee agent connector is a Python package that equips AI agents to interact with Chargebee through strongly typed, well-documented tools. It's ready to use directly in your Python app, in an agent framework, or exposed through an MCP.
+
+Connector for the Chargebee billing and subscription management API. Supports reading subscriptions, customers, invoices, credit notes, coupons, transactions, events, orders, items, item prices, and payment sources. Chargebee is a recurring billing platform that helps SaaS and subscription businesses manage the full subscription lifecycle.
+
+
+## Example questions
+
+The Chargebee connector is optimized to handle prompts like these.
+
+- List all active subscriptions
+- Show me details for a specific customer
+- List recent invoices
+- Show me details for a specific subscription
+- List all coupons
+- List recent transactions
+- List recent events
+- Show me customers with the highest monthly recurring revenue
+- Which subscriptions are set to cancel in the next 30 days?
+- List all overdue invoices and their amounts
+- Analyze subscription churn trends over the past quarter
+- What are the most popular items by number of subscriptions?
+- Show me total revenue breakdown by currency
+- Identify customers with expiring payment sources
+- Compare subscription plan distribution across item prices
+- List all credit notes issued in the past month
+- What is the average subscription lifetime for each plan?
+
+## Unsupported questions
+
+The Chargebee connector isn't currently able to handle prompts like these.
+
+- Create a new subscription in Chargebee
+- Update a customer's billing address
+- Cancel a subscription
+- Apply a coupon to a subscription
+- Issue a refund for an invoice
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-chargebee
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector
+from airbyte_agent_chargebee.models import ChargebeeAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=ChargebeeAuthConfig(
+        api_key="<Your Chargebee API key (used as the HTTP Basic username)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ChargebeeConnector.tool_utils
+async def chargebee_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+If your Airbyte client can access multiple organizations, also set `organization_id`.
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_chargebee import ChargebeeConnector, AirbyteAuthConfig
+
+connector = ChargebeeConnector(
+    auth_config=AirbyteAuthConfig(
+        customer_name="<your_customer_name>",
+        organization_id="<your_organization_id>",  # Optional for multi-org clients
+        airbyte_client_id="<your-client-id>",
+        airbyte_client_secret="<your-client-secret>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ChargebeeConnector.tool_utils
+async def chargebee_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customer | [List](./REFERENCE.md#customer-list), [Get](./REFERENCE.md#customer-get), [Search](./REFERENCE.md#customer-search) |
+| Subscription | [List](./REFERENCE.md#subscription-list), [Get](./REFERENCE.md#subscription-get), [Search](./REFERENCE.md#subscription-search) |
+| Invoice | [List](./REFERENCE.md#invoice-list), [Get](./REFERENCE.md#invoice-get), [Search](./REFERENCE.md#invoice-search) |
+| Credit Note | [List](./REFERENCE.md#credit-note-list), [Get](./REFERENCE.md#credit-note-get), [Search](./REFERENCE.md#credit-note-search) |
+| Coupon | [List](./REFERENCE.md#coupon-list), [Get](./REFERENCE.md#coupon-get), [Search](./REFERENCE.md#coupon-search) |
+| Transaction | [List](./REFERENCE.md#transaction-list), [Get](./REFERENCE.md#transaction-get), [Search](./REFERENCE.md#transaction-search) |
+| Event | [List](./REFERENCE.md#event-list), [Get](./REFERENCE.md#event-get), [Search](./REFERENCE.md#event-search) |
+| Order | [List](./REFERENCE.md#order-list), [Get](./REFERENCE.md#order-get), [Search](./REFERENCE.md#order-search) |
+| Item | [List](./REFERENCE.md#item-list), [Get](./REFERENCE.md#item-get), [Search](./REFERENCE.md#item-search) |
+| Item Price | [List](./REFERENCE.md#item-price-list), [Get](./REFERENCE.md#item-price-get), [Search](./REFERENCE.md#item-price-search) |
+| Payment Source | [List](./REFERENCE.md#payment-source-list), [Get](./REFERENCE.md#payment-source-get), [Search](./REFERENCE.md#payment-source-search) |
+
+
+### Authentication
+
+For all authentication options, see the connector's [authentication documentation](AUTH.md).
+
+### Chargebee API docs
+
+See the official [Chargebee API reference](https://apidocs.chargebee.com/docs/api).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** b3431b73e8fc55d38ab8e68a9f96fef6278c7440
+- **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/chargebee/CHANGELOG.md)