get_catalog_info
Get product catalog details including product count, vertical, name, and connected pixel event sources by providing a catalog ID.
Instructions
Get catalog details including product count, vertical, name, and connected event sources (pixels).
Args: catalog_id: Product catalog ID (numeric string).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| catalog_id | Yes |
Implementation Reference
- meta_ads_mcp/core/catalogs.py:29-82 (handler)The main handler function for the get_catalog_info tool. Calls Meta's Graph API to fetch catalog details (id, name, product_count, vertical, da_display_settings) and enriches with connected pixels, product sets, feeds, and rate limit info.
def get_catalog_info(catalog_id: str) -> dict: """ Get catalog details including product count, vertical, name, and connected event sources (pixels). Args: catalog_id: Product catalog ID (numeric string). """ api_client._ensure_initialized() try: result = api_client.graph_get( f"/{catalog_id}", fields=[ "id", "name", "product_count", "vertical", "da_display_settings", ], ) # Get connected pixels (external_event_sources) try: event_sources = api_client.graph_get( f"/{catalog_id}/external_event_sources", fields=["id", "name"], ) result["connected_pixels"] = event_sources.get("data", []) except MetaAPIError: result["connected_pixels"] = [] # Get product sets try: sets_result = api_client.graph_get( f"/{catalog_id}/product_sets", fields=["id", "name", "product_count"], ) result["product_sets"] = sets_result.get("data", []) except MetaAPIError: result["product_sets"] = [] # Get feeds try: feeds_result = api_client.graph_get( f"/{catalog_id}/product_feeds", fields=["id", "name", "product_count", "latest_upload", "schedule"], ) result["feeds"] = feeds_result.get("data", []) except MetaAPIError: result["feeds"] = [] result["rate_limit_usage_pct"] = api_client.rate_limits.max_usage_pct return result except MetaAPIError: raise - meta_ads_mcp/core/catalogs.py:28-29 (registration)The @mcp.tool() decorator registers this function as an MCP tool named 'get_catalog_info'.
@mcp.tool() def get_catalog_info(catalog_id: str) -> dict: - meta_ads_mcp/core/catalogs.py:29-36 (schema)The type signature (catalog_id: str -> dict) and docstring define the input schema for the tool.
def get_catalog_info(catalog_id: str) -> dict: """ Get catalog details including product count, vertical, name, and connected event sources (pixels). Args: catalog_id: Product catalog ID (numeric string). """