ArmaVita Meta Ads MCP

Instructions

Implementation Reference

• src/armavita_meta_ads_mcp/core/research_tools.py:454-488 (handler)

  The handler implementation for the 'read_web_content' tool, which fetches record data by ID using a cache-first approach with an API fallback.

  async def read_web_content(resource_id: str) -> str:
      """Fetch complete record data by ID using cache-first + API fallback behavior."""
      if not resource_id:
          return json.dumps({"error": "resource_id parameter is required"}, indent=2)
  
      meta_access_token: Optional[str] = None
      try:
          meta_access_token = await auth.get_current_access_token()
      except Exception as token_error:
          logger.debug(f"No access token for read_web_content fallback: {token_error}")
  
      try:
          record = await _data_manager.fetch_record(resource_id, meta_access_token)
          if record:
              logger.info(f"Record fetched successfully: {resource_id}")
              return json.dumps(record, indent=2)
  
          return json.dumps({"error": f"Record not found: {resource_id}", "resource_id": resource_id}, indent=2)
      except ValueError as value_error:
          return json.dumps(
              {
                  "error": "invalid_record_id",
                  "details": str(value_error),
                  "supported_prefixes": list(_SUPPORTED_PREFIXES),
                  "resource_id": resource_id,
              },
              indent=2,
          )
      except Exception as e:
          logger.error(f"Error in read_web_content tool: {e}")
          return json.dumps(
              {
                  "error": "Failed to read_web_content record",
                  "details": str(e),
                  "resource_id": resource_id,

• src/armavita_meta_ads_mcp/core/__init__.py:86-86 (registration)

  The registration of the 'read_web_content' tool within the core package.

  "read_web_content",