Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUTH_METHOD | No | Authentication method - 'direct' for BYOA or 'openbridge' for partner app | |
| AMAZON_AD_API_PACKAGES | No | Comma-separated list of tool packages to activate (e.g., 'profiles,amc-workflow') | |
| AMAZON_AD_API_CLIENT_ID | No | Your Amazon Ads API client ID (required for BYOA) | |
| OPENBRIDGE_REFRESH_TOKEN | No | Your Openbridge API token (required when using Openbridge partner app) | |
| AMAZON_AD_API_CLIENT_SECRET | No | Your Amazon Ads API client secret (required for BYOA) |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| set_active_profile | Set the active profile ID for API calls |
| get_active_profile | Get the currently active profile ID |
| clear_active_profile | Clear the active profile ID |
| set_region | Set the region for Amazon Ads API calls |
| get_region | Get the current region setting |
| list_regions | List all available regions |
| get_routing_state | Get the current routing state including region, host, and headers |
| download_export | Download a completed export to local storage |
| list_downloads | List all downloaded exports and reports |
| set_active_identity | Set the active identity for Amazon Ads API calls |
| get_active_identity | Get the currently active identity |
| list_identities | List all available identities |
| ac_RegisterAdsAccount | Create a new advertising account tied to a specific Amazon vendor, seller or author, or to a business who does not sell on Amazon. Requires one of these permissions: [] |
| ac_ListAdsAccounts | List all advertising accounts for the user associated with the access token. Requires one of these permissions: [] |
| ac_GetAccount | Request attributes of a given advertising account. Requires one of these permissions: [] Path Parameters:
|
| ac_CreateTermsToken | Create a new UUID terms token for the customer to accept advertising terms Requires one of these permissions: [] |
| ac_GetTermsToken | Get the terms token status for the customer Requires one of these permissions: [] Path Parameters:
|
| ac_listProfiles | Note that this operation does not return a response unless the current account has created at least one campaign using the advertising console. |
| ac_updateProfiles | Note that this operation is only used for Sellers using Sponsored Products. This operation is not enabled for vendor type accounts. |
| ac_getProfileById | This operation does not return a response unless the current account has created at least one campaign using the advertising console. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| auth_profile_setup | Complete authentication and profile setup for Amazon Ads API |
| export_entity_download | Request entity export, poll status, and download when ready |
| create_campaign | Create a new advertising campaign with proper validation |
| troubleshoot_api_error | Diagnose and recover from common API errors |
| generate_async_report | Create and retrieve an async report with polling |
| setup_region | Configure region for API routing |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |